MCP 服务器

TickTick MCP Server

Enables AI assistants to manage TickTick tasks and projects through OAuth2 authentication, supporting task creation, updates, completion, project management, and smart daily scheduling based on priorities and due dates.

README

TickTick MCP Server 🎯

TickTick.com | Manage Your Tasks with AI

</div>

A comprehensive MCP (Model Context Protocol) server for managing your TickTick tasks directly from Claude or any MCP-compatible AI assistant.

Features ✨

Task Management: Create, update, complete, and delete tasks
Project Management: Create and manage projects/lists
Smart Scheduling: Generate daily schedules based on task priorities and due dates
OAuth2 Authentication: Secure authentication with TickTick's official API
Rich Formatting: Beautiful markdown output for easy reading

Prerequisites

Python 3.10 or higher
A TickTick account
A TickTick Developer App (we'll create this below)

Installation

Step 1: Clone/Copy the Server

# Create directory
mkdir -p ~/ticktick-mcp
cd ~/ticktick-mcp

# Copy the files (ticktick_mcp.py and pyproject.toml)

Step 2: Install Dependencies

# Using pip
pip install mcp httpx pydantic

# Or using the project
cd ~/ticktick-mcp
pip install -e .

Step 3: Register a TickTick Developer App

Go to TickTick Developer Portal
Log in with your TickTick account
Click "+ App Name" to create a new app
Enter a name (e.g., "Claude MCP Integration")
Important: Set the OAuth Redirect URL to: http://127.0.0.1:8080/callback
Click Save
Note down your Client ID and Client Secret

Configuration

For Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ticktick": {
      "command": "python",
      "args": ["/path/to/ticktick-mcp/ticktick_mcp.py"],
      "env": {}
    }
  }
}

Using uv (recommended):

{
  "mcpServers": {
    "ticktick": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ticktick-mcp", "python", "ticktick_mcp.py"]
    }
  }
}

For Other MCP Clients

Run the server directly:

python ticktick_mcp.py

First-Time Setup (OAuth Authentication)

Once the MCP server is connected, use these tools in order:

1. Configure Credentials

Tell Claude:

"Configure TickTick with my credentials: Client ID is YOUR_CLIENT_ID and Client Secret is YOUR_CLIENT_SECRET"

This will:

Save your credentials securely
Generate an authorization URL for you to visit

2. Authorize the App

Claude will provide an authorization URL
Open the URL in your browser
Log in to TickTick and click "Allow"
You'll be redirected to a URL like: http://127.0.0.1:8080/callback?code=ABCD1234&state=mcp_auth
Copy the code parameter (ABCD1234 in this example)

3. Complete Authorization

Tell Claude:

"Complete TickTick authorization with code: ABCD1234"

You're now authenticated! The token is cached for ~6 months.

Available Tools

Authentication

Tool	Description
`ticktick_configure`	Configure API credentials
`ticktick_authorize`	Complete OAuth flow
`ticktick_check_auth`	Check authentication status

Tasks

Tool	Description
`ticktick_list_tasks`	List all incomplete tasks
`ticktick_get_task`	Get details of a specific task
`ticktick_create_task`	Create a new task
`ticktick_update_task`	Update an existing task
`ticktick_complete_task`	Mark a task as complete
`ticktick_delete_task`	Delete a task