TickTick 的模型上下文协议（MCP）服务器，使用户能够通过 Claude 及其他 MCP 客户端直接与您的 TickTick 任务管理系统交互。

特色

• 📋 查看你所有的 TickTick 项目和任务
• ✏️ 通过自然语言创建新项目和任务
• 🔄 更新现有任务细节（标题、内容、日期、优先级）
• ✅ 将任务标记为完成
• 🗑️ 删除任务和项目
• 🔄 与 TickTick 的开放 API 完全集成
• 🔌 与 Claude 及其他 MCP 客户端无缝集成

先修条件

• Python 3.10 或更高版本
• uv - 快速 Python 软件包安装器和解析器
• 带有API访问权限的TickTick账户
• TickTick API 凭证（客户端 ID、客户端秘密、访问令牌）

安装

1. 克隆此仓库：

2. 用uv安装：

3. 使用 TickTick 认证：

这将：

• 索取您的TickTick客户端ID和客户端秘密信息
• 打开浏览器窗口登录 TickTick
• 自动将访问令牌保存到.env文件中

4. 测试你的配置：

这会验证你的 TickTick 凭证是否正确工作。

用TickTick认证

TickTick MCP Server

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

Features

• 📋 View all your TickTick projects and tasks
• ✏️ Create new projects and tasks through natural language
• 🔄 Update existing task details (title, content, dates, priority)
• ✅ Mark tasks as complete
• 🗑️ Delete tasks and projects
• 🔄 Full integration with TickTick’s open API
• 🔌 Seamless integration with Claude and other MCP clients

Prerequisites

• 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)

Installation

1. Clone this repository:

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

2. Install with uv:

   # Install uv if you don't have it already
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Create a virtual environment
   uv venv
   
   # Activate the virtual environment
   # On macOS/Linux:
   source .venv/bin/activate
   # On Windows:
   .venv\Scripts\activate
   
   # Install the package
   uv pip install -e .
   

3. Authenticate with TickTick:

   # Run the authentication flow
   uv run -m ticktick_mcp.cli auth
   

   This will:

   • Ask for your TickTick Client ID and Client Secret
   • Open a browser window for you to log in to TickTick
   • Automatically save your access tokens to a .env file

4. Test your configuration:

   uv run test_server.py
   

   This will verify that your TickTick credentials are working correctly.

Authentication with TickTick

This server uses OAuth2 to authenticate with TickTick. The setup process is straightforward:

1. Register your application at the TickTick Developer Center

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

2. Run the authentication command:

   uv run -m ticktick_mcp.cli auth
   

3. Follow the prompts to enter your Client ID and Client Secret

4. A browser window will open for you to authorize the application with your TickTick account

5. After authorizing, you’ll be redirected back to the application, and your access tokens will be automatically saved to the .env file

The server handles token refresh automatically, so you won’t need to reauthenticate unless you revoke access or delete your .env file.

Authentication with Dida365

滴答清单 - Dida365 is China version of TickTick, and the authentication process is similar to TickTick. Follow these steps to set up Dida365 authentication:

1. Register your application at the Dida365 Developer Center