MCP server for using the TickTick API
MCP server for using the TickTick API. That is what the ticktick mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.
MCP Server for the TickTick API, enabling task management, project organization, habit tracking, and more.
Installation goes through your MCP client rather than a global install: point it at @alexarevalo.ai/mcp-server-ticktick on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
The server publishes 7 tools. What each one is for:
Inputs — - projectId (string): Project identifierReturns — Task object matching TickTickTaskSchemaproject — Project object matching TickTickProjectSchematasks — Array of task objects matching TickTickTaskSchemacolumns — Optional array of column objects with:Features — The Features tool exposed by this serverBuild — The Build tool exposed by this serverConfiguration is passed through the environment: TICKTICK_CLIENT_ID, TICKTICK_CLIENT_SECRET, TICKTICK_ACCESS_TOKEN, YOUR_CLIENT_ID, YOUR_CLIENT_SECRET, GENERATED_TOKEN, YOUR_ACCESS_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Ticktick's toolset — Inputs, Returns, project and 4 more — is a fair guide to whether it matches your workflow. It is maintained by alexarevalo9; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| Inputs | - projectId (string): Project identifier |
| Returns | Task object matching TickTickTaskSchema |
| project | Project object matching TickTickProjectSchema |
| tasks | Array of task objects matching TickTickTaskSchema |
| columns | Optional array of column objects with: |
| Features | The Features tool exposed by this server. |
| Build | The Build tool exposed by this server. |
#### Docker
```json
{
"mcpServers": {
"ticktick": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TICKTICK_CLIENT_ID",
"-e",
"TICKTICK_CLIENT_SECRET",
"-e",
"TICKTICK_ACCESS_TOKEN",
"mcp/ticktick"
],
"env": {
"TICKTICK_CLIENT_ID": "<YOUR_CLIENT_ID>",
"TICKTICK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"TICKTICK_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| TICKTICK_CLIENT_ID | Configuration value read at startup. | Optional |
| TICKTICK_CLIENT_SECRET | Credential the server authenticates with. | Yes |
| TICKTICK_ACCESS_TOKEN | Credential the server authenticates with. | Yes |
| YOUR_CLIENT_ID | Configuration value read at startup. | Optional |
| YOUR_CLIENT_SECRET | Credential the server authenticates with. | Yes |
| GENERATED_TOKEN | Credential the server authenticates with. | Yes |
| YOUR_ACCESS_TOKEN | Credential the server authenticates with. | Yes |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.