TickTick MCP Server
2025.03.22
22
Python任务管理自然语言交互日程管理
TickTick MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于与 TickTick 任务管理系统进行交互。通过该服务，用户可以直接通过 Claude 和其他 MCP 客户端管理 TickTick 中的项目和任务。
View on GitHub
Overview
基本能力
产品定位
TickTick MCP Server 是一个任务管理工具，旨在通过 MCP 协议与 TickTick 任务管理系统进行无缝集成，提供自然语言交互的能力。
核心功能
- 📋 查看所有 TickTick 项目和任务
- ✏️ 通过自然语言创建新项目和任务
- 🔄 更新现有任务的详细信息（标题、内容、日期、优先级）
- ✅ 标记任务为完成
- 🗑️ 删除任务和项目
- 🔄 与 TickTick 开放 API 的完整集成
- 🔌 与 Claude 和其他 MCP 客户端的无缝集成
适用场景
- 通过自然语言管理任务和项目
- 自动化任务创建和更新
- 与 Claude 等 AI 工具集成，提升任务管理效率
工具列表
| 工具 | 描述 | 参数 |
|---|---|---|
get_projects |
列出所有 TickTick 项目 | 无 |
get_project |
获取特定项目的详细信息 | project_id |
get_project_tasks |
列出项目中的所有任务 | project_id |
get_task |
获取特定任务的详细信息 | project_id, task_id |
create_task |
创建新任务 | title, project_id, content (可选), start_date (可选), due_date (可选), priority (可选) |
update_task |
更新现有任务 | task_id, project_id, title (可选), content (可选), start_date (可选), due_date (可选), priority (可选) |
complete_task |
标记任务为完成 | project_id, task_id |
delete_task |
删除任务 | project_id, task_id |
create_project |
创建新项目 | name, color (可选), view_mode (可选) |
delete_project |
删除项目 | project_id |
常见问题解答
- 如何获取 TickTick API 凭证？ 需要在 TickTick Developer Center 注册应用并设置重定向 URI。
- 如何自动刷新令牌？ 服务器会自动处理令牌刷新，无需手动操作。
使用教程
使用依赖
- Python 3.10 或更高版本
- uv - 快速 Python 包安装器和解析器
- TickTick 账户和 API 凭证（Client ID, Client Secret, Access Token）
安装教程
-
克隆仓库:
bash git clone https://github.com/parkjs814/ticktick-mcp.git cd ticktick-mcp -
使用 uv 安装: ```bash # 安装 uv（如果尚未安装） curl -LsSf https://astral.sh/uv/install.sh | sh
# 创建虚拟环境 uv venv
# 激活虚拟环境 # macOS/Linux: source .venv/bin/activate # Windows: .venv\Scripts\activate
# 安装包 uv pip install -e . ```
-
TickTick 认证:
bash # 运行认证流程 uv run -m ticktick_mcp.cli auth -
测试配置:
bash uv run test_server.py
调试方式
- 运行测试脚本以验证配置是否正确。
- 检查
.env文件中的令牌是否正确。 - 确保重定向 URI 设置为
http://localhost:8000/callback。