A Model Context Protocol (MCP) server for TickTick that enables interacting with your TickTick task management system directly through Claude and other MCP clients.

✨ Supports both TickTick (International) and Dida365 滴答清单 (China) with automatic configuration!

⚠️ Note: TickTick/Dida365 official APIs have reliability issues and may return HTTP 500 errors frequently. This MCP server includes robust error handling and retry logic to work around these limitations.

• Task Management: Create, update, complete, and delete tasks across all projects
• Advanced Search: Filter tasks by status, priority, project, and content
• Task Migration: Move tasks between projects with full data preservation
• Batch Operations: Complete or delete multiple tasks at once
• Project Management: Create, update, and manage TickTick projects

• Python 3.10 or higher
• uv - Fast Python package installer and resolver
• TickTick account with API access
• TickTick API credentials (Client ID, Client Secret, Access Token)

1. Clone this repository:

   git clone https://github.com/jacepark12/ticktick-mcp.git
   cd ticktick-mcp

2. Install as global tool:

   # Install uv if you don't have it already
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Install as global tool from local source
   uv tool install --editable .

3. Register your application at TickTick Developer Center or Dida365 Developer Center

   • Set the redirect URI to http://localhost:8000/callback
   • Note your Client ID and Client Secret

4. Authenticate:

   ticktick-mcp auth

   Follow the prompts and authorize in your browser.

5. Verify setup:

   ticktick-mcp status

{
  "mcpServers": {
    "ticktick": {
      "command": "/absolute/path/to/ticktick-mcp",
      "args": ["run"],
      "env": {}
    }
  }
}

Use which ticktick-mcp to find the absolute path.

The TickTick MCP server provides 15 comprehensive tools for managing your tasks and projects: