# Ticktick — MCP server on mcp.ai
> TickTick is a cross-platform task management and to-do list application designed to help users organize their tasks and schedules efficiently.

By: mcp.ai · official
Page: https://mcp.ai/ticktick

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_ticktick?ms=1781542320000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/ticktick/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/ticktick/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/ticktick/skill.md
Postman collection (v2.1): https://mcp.ai/ticktick/postman.json

## Tools
- ticktick_complete_task(task_id: string, project_id: string) — Tool to mark a task as complete. use after confirming the task is done.
- ticktick_create_task(desc?: string, items?: object[], title: string, content?: string, dueDate?: string, isAllDay?: boolean, priority?: integer, timeZone?: string, projectId?: string, reminders?: string[], sortOrder?: integer, startDate?: string, repeatFlag?: string) — Tool to create a new task in ticktick. use after you have task details such as title, dates, and optional reminders or subtasks.
- ticktick_delete_task(task_id: string, project_id: string) — Tool to delete a specific task. use when you need to remove a task from a project after confirming both project and task ids.
- ticktick_get_user_project() — Tool to retrieve all projects for the user. use when you need to list available projects for selection.
- ticktick_ticktick_complete_task(task_id: string, project_id: string) — Tool to mark a specific task as complete. use after confirming the task is done.
- ticktick_ticktick_create_project(kind?: string, name: string, color?: string, viewMode?: string, sortOrder?: integer) — Tool to create a new project in ticktick. use when you need to programmatically add a project after obtaining a valid access token.
- ticktick_ticktick_delete_project(project_id: string) — Tool to delete a specific project. use when you have confirmed the project id and intend to permanently remove it. example: "delete the project with id 6226ff9877acee87727f6bca".
- ticktick_ticktick_get_project_with_data(projectId: string) — Tool to retrieve a project and its associated data (tasks, columns). use when you need full project details including its tasks and columns after selecting a project id.
- ticktick_ticktick_oauth2_authorization_step_1(scope: string, state?: string, client_id: string, redirect_uri: string) — Tool to redirect user to ticktick authorization page to obtain authorization code. use when initiating the oauth2 flow before exchanging the code.
- ticktick_ticktick_oauth2_authorization_step1(scope: string, state?: string, client_id: string, redirect_uri: string) — Tool to generate the ticktick oauth2 authorization url. use to redirect the user to obtain the authorization code (step 1).
- ticktick_ticktick_update_project(kind?: string, name?: string, color?: string, viewMode?: string, projectId: string, sortOrder?: integer) — Tool to update an existing project. use when you need to modify project details like name, color, sort order, view mode, or kind after selecting a project id.
- ticktick_update_project(kind?: string, name?: string, color?: string, viewMode?: string, projectId: string, sortOrder?: integer) — Tool to update an existing project. use when you need to modify project details like name, color, sort order, view mode, or kind after selecting a project id.
- ticktick_update_task(desc?: string, items?: object[], title?: string, taskId: string, content?: string, dueDate?: string, isAllDay?: boolean, priority?: integer, timeZone?: string, projectId: string, reminders?: string[], sortOrder?: integer, startDate?: string, repeatFlag?: string) — Tool to update an existing task. use after confirming the taskid and projectid.

## Links
Docs: https://mcp.ai/docs/mcps/ticktick
Website: https://mcp.ai/mcps/ticktick