TickTick MCP Server
2025.04.14
4
TypeScript任务管理项目管理习惯跟踪日程管理
TickTick MCP Server 是一个用于 TickTick API 的服务，支持任务管理、项目组织、习惯跟踪等功能。它提供了完整的 OAuth2 认证实现，确保 API 访问的安全性。
View on GitHub
Overview
基本能力
产品定位
TickTick MCP Server 是一个任务管理和项目组织的服务，通过 API 提供对 TickTick 功能的访问。
核心功能
- 任务管理：创建、读取、更新和删除任务，支持所有可用属性。
- 项目管理：创建、读取、更新和删除项目，支持自定义视图。
- 子任务支持：完全支持管理父任务中的子任务。
- 任务控制：设置优先级、截止日期、提醒和重复规则。
- OAuth 认证：完整的 OAuth2 实现，确保 API 访问的安全性。
- 错误处理：清晰的错误消息，处理常见问题。
适用场景
- 个人任务管理
- 团队项目协作
- 习惯跟踪和提醒
工具列表
- get_task_by_ids：通过项目 ID 和任务 ID 获取特定任务。
- create_task：在项目中创建新任务。
- update_task：更新现有任务。
- complete_task：标记任务为已完成。
- delete_task：从项目中删除任务。
- get_user_projects：获取认证用户的所有项目。
- get_project_by_id：通过 ID 获取特定项目。
- get_project_with_data：获取项目详情及任务和列。
- create_project：创建新项目。
- update_project：更新现有项目。
- delete_project：删除项目。
常见问题解答
- OAuth 认证问题：确保正确注册应用并配置重定向 URL。
- 任务属性错误：检查优先级、日期格式等是否符合要求。
使用教程
使用依赖
- 需要注册 TickTick 开发者账号并获取 API 凭证。
安装教程
- Docker 安装：
bash docker build -t mcp/ticktick -f src/ticktick/Dockerfile . - NPX 安装：
json { "mcpServers": { "ticktick": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-ticktick"], "env": { "TICKTICK_CLIENT_ID": "<YOUR_CLIENT_ID>", "TICKTICK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>" } } } }
调试方式
- 使用
get_user_projects检查项目列表是否正确加载。 - 使用
create_task测试任务创建功能。