TickTick MCP Server

What is TickTick MCP Server?

A Model Context Protocol server that lets you manage your TickTick tasks and projects directly through Claude or any other MCP client, using TickTick’s open API.

How to use TickTick MCP Server?

Install the package with uv, run the OAuth2 authentication command (uv run -m ticktick_mcp.cli auth), and configure Claude for Desktop by adding the server entry to claude_desktop_config.json. Once connected, MCP tools become available in the client.

Key features of TickTick MCP Server

• View all TickTick projects and tasks
• Create, update, complete, and delete tasks
• Create and delete projects
• Search tasks by title, content, or subtasks
• Filter tasks by priority, due date, or overdue status
• Batch-create multiple tasks at once

Use cases of TickTick MCP Server

• List projects and tasks, then ask for details or next steps
• Create a new task with a specific priority and due date using natural language
• Check what tasks are due today, tomorrow, or this week
• Search for tasks containing a given keyword
• Apply a GTD workflow: identify engaged and next actions, then break down work

FAQ from TickTick MCP Server

What are the prerequisites?

Python 3.10 or higher, uv (fast package installer), and a TickTick account with API credentials (Client ID, Client Secret, Access Token).

How does authentication work?

The server uses OAuth2. Running uv run -m ticktick_mcp.cli auth opens a browser to authorize your account, then automatically saves the tokens in a .env file. Token refresh is handled automatically.

Can I use this with Dida365 (the Chinese version of TickTick)?

Yes. Set environment variables for the Dida365 API URLs before authentication, then follow the same OAuth2 steps.

Which MCP clients are supported?

The server works with any MCP client, including Claude for Desktop. Configuration requires adding the server to the client's MCP settings file.

How are my data and credentials stored?

API tokens are stored locally in a .env file. All task data resides on TickTick’s servers and is accessed via their official API.