Tick Tick Mcp

What is Tick Tick Mcp?

Tick Tick Mcp connects Claude to your TickTick account, allowing you to manage your entire task system through natural conversation. It provides 28 tools for full CRUD operations, smart queries, multi-condition filters, batch operations, and GTD support.

How to use Tick Tick Mcp?

Clone the repository, install dependencies, run TICKTICK_CLIENT_ID=your_id TICKTICK_CLIENT_SECRET=your_secret .venv/bin/python3 setup_auth.py to authenticate via OAuth, then register with Claude Code using claude mcp add ticktick or by editing claude_desktop_config.json.

Key features of Tick Tick Mcp

• 28 tools covering projects, tasks, subtasks, and user preferences
• Full CRUD and batch operations (up to 20 tasks at once)
• Multi-condition filters (priority + tag + date + project + status)
• GTD focus view: high priority + due today + overdue tasks
• Dida365 (Chinese TickTick) support via configurable base URL
• Async httpx, Pydantic input validation, and MCP annotations

Use cases of Tick Tick Mcp

• Create tasks with due dates, priorities, and projects via natural language
• Search across all projects, check overdue or due-this-week tasks
• Batch create, update, or complete multiple tasks in one command
• Create and manage projects, subtasks, and move tasks between projects
• View completed tasks, user preferences, and GTD-focused task lists

FAQ from Tick Tick Mcp

What are the prerequisites for Tick Tick Mcp?

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

How do I authenticate Tick Tick Mcp?

You must register a developer app on developer.ticktick.com with OAuth redirect URL http://localhost:8080/callback, then run setup_auth.py with your Client ID and Client Secret to authorize via browser.

Does Tick Tick Mcp support Dida365?

Yes — set TICKTICK_BASE_URL=https://api.dida365.com/open/v1 and TICKTICK_TOKEN_URL=https://dida365.com/oauth/token to use Dida365.

Where are my tokens stored?

Tokens are stored locally at ~/.ticktick_mcp/tokens.json and are automatically refreshed with a 60-second buffer.

What if my tokens expire?

Re-run setup_auth.py to get fresh tokens. The server also handles token refresh transparently.