ticktick-mcp

A Model Context Protocol (MCP) server for TickTick, exposing all TickTick Open API endpoints as MCP tools so Claude (and any MCP-compatible AI) can manage your tasks and projects.

Features

• 🗂 Full Project Management — list, get, create, update, delete projects

• ✅ Full Task Management — create, read, update, complete, delete tasks

• 🔀 Move Tasks — move tasks between projects

• 🔍 Advanced Filtering — filter tasks by project, date, priority, tag, status

• 📋 Completed Tasks — query completed tasks within any date range

• 🔐 Simple Token Auth — just set an env var, no OAuth dance needed

• ⚡ Zero Config — run instantly with npx

Related MCP server: TickTick MCP Server

Quick Start

1. Get a TickTick API Access Token

Go to developer.ticktick.com and register an application to obtain an access token (or use a personal access token from the dashboard).

2. Run with npx

TICKTICK_ACCESS_TOKEN=your_token_here npx ticktick-mcp

3. Or install globally

npm install -g ticktick-mcp
TICKTICK_ACCESS_TOKEN=your_token_here ticktick-mcp

Claude Desktop Configuration

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "ticktick": {
      "command": "npx",
      "args": ["ticktick-mcp"],
      "env": {
        "TICKTICK_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

The config file is located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Environment Variables

Available Tools

Project Tools

Task Tools

Task Priority Values

Task Status Values

Example Prompts (for Claude)

Once connected, you can ask Claude things like:

• "Show me all my TickTick projects"

• "Create a task called 'Review PR' in my Work project, due tomorrow with high priority"

• "List all tasks in the 'Personal' project"

• "Mark the task [task ID] as complete"

• "Move the task [task ID] from 'Inbox' to 'Work'"

• "What tasks did I complete last week?"

• "Find all high-priority tasks due this month"

Development

git clone <repo>
cd ticktick-mcp
npm install
TICKTICK_ACCESS_TOKEN=your_token npm run dev

API Reference

This server implements the TickTick Open API.

• Base URL: https://api.ticktick.com

• Auth: Bearer token (Authorization: Bearer <token>)

• Scopes: tasks:read, tasks:write