ticktick-mcp-server

A Model Context Protocol (MCP) server that connects AI assistants to your TickTick tasks. Create, read, update, complete, and move tasks — all through natural language.

Platform: macOS only. Token storage uses the macOS Keychain. Linux and Windows support is planned.

How It Works

This server implements the Model Context Protocol, allowing AI assistants like Claude to manage your TickTick tasks through natural conversation. Once configured, you can say things like "create a task to buy groceries due Friday" or "show me all my tasks tagged @work."

Prerequisites

• Node.js 18 or later

• A TickTick account

• A TickTick OAuth app:

  1. Go to developer.ticktick.com/manage

  2. Create a new app

  3. Set the Redirect URI to http://localhost:19876/callback

  4. Copy your Client ID and Client Secret

Setup

1. Authorize

Run once to connect the server to your TickTick account:

TICKTICK_CLIENT_ID=your_client_id \
TICKTICK_CLIENT_SECRET=your_client_secret \
npx ticktick-mcp-server-auth

This opens your browser for OAuth consent and stores tokens securely in the macOS Keychain.

2. Configure Your MCP Client

Add to your MCP client config (e.g. Claude Desktop, Claude Code):

{
  "mcpServers": {
    "ticktick": {
      "command": "npx",
      "args": ["-y", "ticktick-mcp-server"],
      "env": {
        "TICKTICK_CLIENT_ID": "your_client_id"
      }
    }
  }
}

Available Tools

Example Prompts

Once configured, try these with your AI assistant:

• "Show me my tasks due this week"

• "Create a task called 'Review PR #42' in my Work project with high priority"

• "Move the grocery list task to my Personal project"

• "What projects do I have in TickTick?"

• "Create a recurring task to pay rent on the 1st of every month"

Troubleshooting

Limitations

• macOS only — uses the macOS Keychain for token storage

• Moving a task creates a copy in the target project and completes the original; task IDs change

• Listing all tasks (without a project filter) fetches each project sequentially

• Subtasks and attachments are not currently supported

License

MIT