MCP server that connects AI agents (Claude Code, Cursor, Codex) to Dida365/TickTick. 40 tools for tasks, projects, tags, habits, folders, and search — manage everything through natural language.
Overview
Features
- 40 tools — 19 V1 (official Open API) + 21 V2 (private API: tags, search, habits, folders, parent tasks)
- Dual platform — Dida365 (China) and TickTick (International) via one env var
- Dual transport —
stdiofor local clients;streamable-httpfor remote agents - One-click OAuth — auto browser flow, token saved for ~180 days
- Docker ready —
docker compose upto deploy
Quick Start
uvx --from dida365-agent-mcp dida365-oauth # OAuth (one-time)
Then add to your MCP client config:
{
"mcpServers": {
"dida365": {
"command": "uvx",
"args": ["dida365-agent-mcp"]
}
}
}
Tools Overview
- Task: create, update, complete, delete, get, move, batch create/update/complete, filter, search
- Project: list, get, create, update, delete
- Tags (V2): list, create, update, delete
- Habits (V2): list, create, update, delete, checkin, undo checkin
- Folders (V2): list, create, update, delete
- Other (V2): parent/child tasks, pin task, search
Full documentation:
Server Config
{
"mcpServers": {
"dida365": {
"command": "uvx",
"args": [
"dida365-agent-mcp"
]
}
}
}