Tick Tick MCP MCP Server

Turn Claude into your AI task manager. Create, manage & complete TickTick tasks just by talking — official OAuth API, local, private.

Remote serverstreamable-httpPython

What is the Tick Tick MCP MCP server?

Turn Claude into your AI task manager. Create, manage & complete TickTick tasks just by talking — official OAuth API, local, private. The tick tick mcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.

What it actually does

Connect Claude to your TickTick account and manage your entire task system through natural conversation -- create tasks, search across projects, check what's overdue, batch-create items, and stay organized without ever opening the app.

Adding it to your client

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

Its toolset

Everything the assistant can do here goes through one of these:

  • ticktick_list_projects — List all projects with IDs, names, colors
  • ticktick_get_project — Get details of a specific project
  • ticktick_get_project_with_tasks — Get project details + all undone tasks in one call
  • ticktick_create_project — Create a new project (name, color, view mode)
  • ticktick_update_project — Update a project's name, color, or view mode
  • ticktick_delete_project — Permanently delete a project
  • ticktick_list_tasks — List all tasks in a specific project
  • ticktick_create_task — Create a task (title, due date, priority, project, tags)
  • ticktick_get_task — Get full details of a specific task
  • ticktick_update_task — Update title, content, dates, or priority
  • ticktick_complete_task — Mark a task as completed
  • ticktick_delete_task — Permanently delete a task

Configuration

You will need 4 environment variables: TICKTICK_CLIENT_ID, TICKTICK_CLIENT_SECRET, TICKTICK_BASE_URL, TICKTICK_TOKEN_URL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Caveats

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Tick Tick MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the tick tick mcp mcp server does with a few real requests.

When to reach for it

Among the planning and project tracking options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Tick Tick MCP's toolset — ticktick_list_projects, ticktick_get_project, ticktick_get_project_with_tasks and 11 more — is a fair guide to whether it matches your workflow. It is maintained by Salen-Project; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Tick Tick MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
ticktick_list_projectsList all projects with IDs, names, colors
ticktick_get_projectGet details of a specific project
ticktick_get_project_with_tasksGet project details + all undone tasks in one call
ticktick_create_projectCreate a new project (name, color, view mode)
ticktick_update_projectUpdate a project's name, color, or view mode
ticktick_delete_projectPermanently delete a project
ticktick_list_tasksList all tasks in a specific project
ticktick_create_taskCreate a task (title, due date, priority, project, tags)
ticktick_get_taskGet full details of a specific task
ticktick_update_taskUpdate title, content, dates, or priority
ticktick_complete_taskMark a task as completed
ticktick_delete_taskPermanently delete a task
ticktick_create_subtaskCreate a subtask under a parent task
ticktick_get_all_tasksGet all tasks across all active projects

Configuration

VariableDescriptionRequired
TICKTICK_CLIENT_IDConfiguration value read at startup.Optional
TICKTICK_CLIENT_SECRETCredential the server authenticates with.Yes
TICKTICK_BASE_URLEndpoint or connection string the server talks to.Yes
TICKTICK_TOKEN_URLCredential the server authenticates with.Yes

Example prompts to try

  • Use Tick Tick MCP to ticktick list projects.
  • Use Tick Tick MCP to ticktick get project.
  • Use Tick Tick MCP to ticktick get project with tasks.

Frequently asked questions

A TickTick account, Python 3.10+, and either Claude Code or Claude Desktop are required.