Salen-Project/ticktick-mcp

**28 tools. Full CRUD. Smart queries. Multi-condition filters. Batch operations. GTD support. Dida365 compatible.**
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.
> "What's overdue?" --> Instantly shows all missed deadlines across every project.
---
Why This One?
| Feature | This Server | TickTick Official MCP | jacepark12 |
|---|---|---|---|
| **Tools** | **28** | 22 | ~20 |
| **Multi-condition filter** | Yes (priority + tag + date + project) | Yes | No |
| **Move task between projects** | Yes | Yes | No |
| **Bulk complete** | Yes (up to 20) | Yes (up to 20) | No |
| **Batch update** | Yes | Yes | No |
| **Completed tasks view** | Yes | Yes | No |
| **Cross-project search** | Full text search | Yes | Yes |
| **Subtasks** | Yes | No | No |
| **GTD focus view** | Yes (high priority + due + overdue) | No | Partial |
| **Dida365 support** | Yes (configurable base URL) | No | Yes |
| **Async (httpx)** | Yes | N/A | No (sync requests) |
| **Pydantic validation** | Yes (typed inputs) | N/A | No |
| **MCP annotations** | Yes (readOnly, destructive hints) | N/A | No |
| **Self-hosted / open source** | Yes | No (hosted service) | Yes |
| **Privacy** | 100% local, your tokens only | Goes through TickTick servers | 100% local |
---
Quick Start
Prerequisites
- TickTick account
- Python 3.10+
- Claude Code or Claude Desktop
Step 1 -- Clone and install
Step 2 -- Register a TickTick developer app
1. Go to developer.ticktick.com
2. Click **New App** and fill in any name
3. Set **OAuth Redirect URL** to: http://localhost:8080/callback
4. Copy your **Client ID** and **Client Secret**
Step 3 -- Authenticate
This opens your browser to authorize the app. Click **Allow** -- tokens are saved to ~/.ticktick_mcp/tokens.json and refresh automatically.
Step 4 -- Register with Claude Code
For Claude Desktop
Add to your claude_desktop_config.json:
Step 5 -- Add the productivity skill (optional)
---
Dida365 Support
For Dida365 (TickTick's Chinese version), set these environment variables:
---
Usage Examples
| You say | What happens |
|---|---|
| "Remind me to call the dentist on Friday" | Task created with due date |
| "Add 'review Q1 report' to Work, high priority" | Task in Work project, priority 5 |
| "What's overdue?" | Shows all overdue tasks across projects |
| "What should I focus on?" | GTD view: high priority + due today + overdue |
| "Search for anything about 'budget'" | Full-text search across all projects |
| "Show me all high priority tasks" | Filters by priority=5 across projects |
| "What's due this week?" | Tasks due in the next 7 days |
| "Create tasks: buy milk, call John, submit report" | Batch creates 3 tasks |
| "Create a project called 'Vacation Planning'" | New project created |
| "Add subtask 'Buy sunscreen' under the vacation task" | Subtask created |
| "I finished the dentist task" | Task marked complete |
| "Delete the old Sprint project" | Project and all tasks deleted |
---
MCP Tools Reference
Projects (5 tools)
| Tool | Description |
|---|---|
| ticktick_list_projects | List all projects with IDs, names, colors |
| ticktick_get_project | Get details of a specific project |