ticktick-mcp
TickTick MCP 服务器 -- Claude 的完整 TickTick 集成
28 个工具。完整 CRUD。智能查询。多条件筛选。批量操作。支持 GTD。兼容滴答清单 (Dida365)。
将 Claude 连接到您的 TickTick 账户,并通过自然对话管理您的整个任务系统——创建任务、跨项目搜索、检查逾期事项、批量创建条目,无需打开应用程序即可保持井井有条。
“有什么逾期的任务?” --> 立即显示所有项目中错过的截止日期。
为什么选择这个?
功能 | 本服务器 | TickTick 官方 MCP | jacepark12 |
工具数量 | 28 | 22 | ~20 |
多条件筛选 | 是(优先级 + 标签 + 日期 + 项目) | 是 | 否 |
跨项目移动任务 | 是 | 是 | 否 |
批量完成 | 是(最多 20 个) | 是(最多 20 个) | 否 |
批量更新 | 是 | 是 | 否 |
已完成任务视图 | 是 | 是 | 否 |
跨项目搜索 | 全文搜索 | 是 | 是 |
子任务 | 是 | 否 | 否 |
GTD 专注视图 | 是(高优先级 + 到期 + 逾期) | 否 | 部分 |
支持滴答清单 (Dida365) | 是(可配置基础 URL) | 否 | 是 |
异步 (httpx) | 是 | N/A | 否(同步请求) |
Pydantic 验证 | 是(类型化输入) | N/A | 否 |
MCP 注解 | 是(只读、破坏性提示) | N/A | 否 |
自托管 / 开源 | 是 | 否(托管服务) | 是 |
隐私 | 100% 本地,仅限您的令牌 | 经过 TickTick 服务器 | 100% 本地 |
Related MCP server: mcp-server-asana
快速入门
前置条件
TickTick 账户
Python 3.10+
Claude Code 或 Claude Desktop
第 1 步 -- 克隆并安装
git clone https://github.com/Salen-Project/ticktick-mcp
cd ticktick-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt第 2 步 -- 注册 TickTick 开发者应用
点击 New App 并填写任意名称
将 OAuth Redirect URL 设置为:
http://localhost:8080/callback复制您的 Client ID 和 Client Secret
第 3 步 -- 身份验证
TICKTICK_CLIENT_ID=your_id TICKTICK_CLIENT_SECRET=your_secret .venv/bin/python3 setup_auth.py这将打开您的浏览器以授权该应用。点击 Allow —— 令牌将保存到 ~/.ticktick_mcp/tokens.json 并自动刷新。
第 4 步 -- 在 Claude Code 中注册
claude mcp add ticktick \
-e TICKTICK_CLIENT_ID=your_id \
-e TICKTICK_CLIENT_SECRET=your_secret \
-- /path/to/ticktick-mcp/.venv/bin/python3 /path/to/ticktick-mcp/server.py针对 Claude Desktop
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"ticktick": {
"type": "stdio",
"command": "/path/to/ticktick-mcp/.venv/bin/python3",
"args": ["/path/to/ticktick-mcp/server.py"],
"env": {
"TICKTICK_CLIENT_ID": "your_id",
"TICKTICK_CLIENT_SECRET": "your_secret"
}
}
}
}第 5 步 -- 添加生产力技能(可选)
mkdir -p ~/.claude/skills/ticktick
cp skills/ticktick/SKILL.md ~/.claude/skills/ticktick/滴答清单 (Dida365) 支持
对于滴答清单(TickTick 的中文版),请设置以下环境变量:
TICKTICK_BASE_URL=https://api.dida365.com/open/v1
TICKTICK_TOKEN_URL=https://dida365.com/oauth/token使用示例
您说 | 发生什么 |
“提醒我周五给牙医打电话” | 创建带有截止日期的任务 |
“在‘工作’项目中添加‘审查第一季度报告’,高优先级” | 在工作项目中创建任务,优先级 5 |
“有什么逾期的任务?” | 显示所有项目中逾期的任务 |
“我应该关注什么?” | GTD 视图:高优先级 + 今天到期 + 逾期 |
“搜索关于‘预算’的任何内容” | 跨所有项目进行全文搜索 |
“显示所有高优先级任务” | 按优先级=5 跨项目筛选 |
“本周到期的是什么?” | 未来 7 天内到期的任务 |
“创建任务:买牛奶,给约翰打电话,提交报告” | 批量创建 3 个任务 |
“创建一个名为‘度假计划’的项目” | 创建新项目 |
“在度假任务下添加子任务‘买防晒霜’” | 创建子任务 |
“我完成了牙医任务” | 将任务标记为完成 |
“删除旧的 Sprint 项目” | 删除项目及其所有任务 |
MCP 工具参考
项目 (5 个工具)
工具 | 描述 |
| 列出所有项目及其 ID、名称、颜色 |
| 获取特定项目的详细信息 |
| 一次调用获取项目详情 + 所有未完成任务 |
| 创建新项目(名称、颜色、视图模式) |
| 更新项目名称、颜色或视图模式 |
| 永久删除项目 |
任务 -- 基础 CRUD (7 个工具)
工具 | 描述 |
| 列出特定项目中的所有任务 |
| 创建任务(标题、截止日期、优先级、项目、标签) |
| 获取特定任务的完整详细信息 |
| 更新标题、内容、日期或优先级 |
| 将任务标记为已完成 |
| 永久删除任务 |
| 在父任务下创建子任务 |
任务 -- 智能查询 (7 个工具)
工具 | 描述 |
| 获取所有活跃项目中的所有任务 |
| 跨标题、内容、子任务进行全文搜索 |
| 按优先级筛选(无/低/中/高) |
| 所有项目中今天到期的任务 |
| 所有项目中逾期的任务 |
| 未来 7 天内到期的任务 |
| 恰好在 N 天后到期的任务 |
任务 -- 批量与生产力 (5 个工具)
工具 | 描述 |
| 一次创建多个任务 |
| 一次更新多个任务 |
| 一次将最多 20 个任务标记为完成 |
| 将任务从一个项目移动到另一个项目 |
| GTD 专注视图:高优先级 + 今天到期 + 逾期 |
任务 -- 高级筛选 (2 个工具)
工具 | 描述 |
| 多条件筛选:优先级 + 标签 + 日期范围 + 项目 + 状态 |
| 查看项目中的已完成任务 |
用户 (1 个工具)
工具 | 描述 |
| 获取用户设置(时区、周起始日等) |
架构
server.py # 20 MCP tools, async httpx, Pydantic validation
setup_auth.py # One-time OAuth 2.0 setup (browser-based)
~/.ticktick_mcp/ # Token storage (auto-refreshed)
skills/ticktick/ # Claude skill for natural task language设计选择:
全程异步 -- 使用
httpx.AsyncClient进行非阻塞 API 调用Pydantic 输入模型 -- 类型安全,经过验证的输入,具有清晰的错误消息
MCP 注解 --
readOnlyHint和destructiveHint用于更安全的工具使用自动令牌刷新 -- 令牌以 60 秒的缓冲时间透明刷新
故障排除
“Given client ID does not match” -- 请仔细检查 developer.ticktick.com 上的 Client ID。
端口 8080 已被占用 -- 运行 lsof -ti:8080 | xargs kill -9 然后重试。
令牌过期 -- 重新运行 setup_auth.py 以获取新令牌。
Claude 看不到工具 -- 运行 claude mcp list 以验证注册情况。
贡献
欢迎贡献!请先开启一个 issue 来讨论您想要更改的内容。
git clone https://github.com/Salen-Project/ticktick-mcp
cd ticktick-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
# Make your changes to server.py
# Test: python3 -c "from server import mcp; print(len(mcp._tool_manager._tools), 'tools')"链接
许可证
MIT (c) Salen-Project
Available Tools
7 toolsticktick_complete_taskBIdempotent
Mark a TickTick task as completed.
Args: params (TaskActionInput): - task_id (str): ID of the task to complete - project_id (str): ID of the project the task belongs to
Returns: str: JSON success confirmation or error message.
Examples: - "Mark the grocery task as done" - "Complete task X"
Inputs: params (required). Returns: result
ticktick_create_taskA
Create a new task in TickTick.
Creates a task with the given title and optional details. If no project_id is provided, the task goes to the Inbox.
Args: params (CreateTaskInput): - title (str): Task title (required) - content (Optional[str]): Notes or description - due_date (Optional[str]): Due date e.g. '2026-03-20' or '2026-03-20T10:00:00+0000' - priority (Optional[int]): 0=None, 1=Low, 3=Medium, 5=High (default: 0) - project_id (Optional[str]): Project ID. Uses Inbox if not set. - tags (Optional[List[str]]): Tag names to apply
Returns: str: JSON with success status and created task details including its new ID.
Examples: - "Add a task to buy groceries" -> title="Buy groceries" - "Remind me to call John tomorrow, high priority" -> title="Call John", priority=5, due_date="2026-03-15" - "Add 'Review report' to my Work project" -> use ticktick_list_projects first to get project_id
Inputs: params (required). Returns: result
ticktick_delete_taskADestructive
Permanently delete a TickTick task. This action cannot be undone.
Args: params (TaskActionInput): - task_id (str): ID of the task to delete - project_id (str): ID of the project the task belongs to
Returns: str: JSON success confirmation or error message.
Examples: - "Delete the grocery task" - "Remove task X permanently"
Inputs: params (required). Returns: result
ticktick_get_taskARead-onlyIdempotent
Get full details of a specific TickTick task by ID.
Args: params (GetTaskInput): - task_id (str): The task ID - project_id (str): The project ID the task belongs to
Returns: str: JSON object with full task details including created and modified timestamps.
Examples: - Use when: You have a task ID and need its current details
Inputs: params (required). Returns: result
ticktick_list_projectsARead-onlyIdempotent
List all TickTick projects (task lists) in the user's account.
Returns all projects with their IDs and names. Use the project ID with other tools to create or list tasks in a specific project.
Returns: str: JSON array of projects, each containing: - id (str): Project ID - name (str): Project name - color (str): Project color - closed (bool): Whether the project is archived
Examples: - Use when: "What projects/lists do I have in TickTick?" - Use when: You need a project ID before creating or listing tasks
Inputs: no named parameters. Returns: result
ticktick_list_tasksARead-onlyIdempotent
List all active tasks in a specific TickTick project.
Fetches all tasks for the given project ID. Use ticktick_list_projects first if you don't know the project ID.
Args: params (ListTasksInput): - project_id (str): Project ID to list tasks from
Returns: str: JSON array of tasks, each with id, title, content, due_date, priority, status, tags, and project_id.
Examples: - Use when: "Show me my tasks in the Work project" - Use when: "What's on my to-do list?"
Inputs: params (required). Returns: result
ticktick_update_taskAIdempotent
Update an existing TickTick task. Only provided fields are changed.
Fetches the current task first, then applies your changes on top, so fields you don't specify are preserved.
Args: params (UpdateTaskInput): - task_id (str): ID of the task to update (required) - project_id (str): Project ID the task belongs to (required) - title (Optional[str]): New task title - content (Optional[str]): New task description - due_date (Optional[str]): New due date (e.g., '2026-03-25') - priority (Optional[int]): New priority: 0=None, 1=Low, 3=Medium, 5=High
Returns: str: JSON with success status and updated task details.
Examples: - "Change the due date of task X to Friday" - "Make task Y high priority" - "Update the title of task Z"
Inputs: params (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Every tool has a clearly distinct purpose with no ambiguity. Each tool targets a specific CRUD operation (create, read, update, delete, list) on either tasks or projects, with clear boundaries between task operations and project operations. The descriptions reinforce distinct use cases.
All tools follow a consistent verb_noun pattern with the 'ticktick_' prefix (e.g., ticktick_create_task, ticktick_list_projects). The naming is perfectly predictable throughout the set, using clear action verbs followed by resource nouns.
With 7 tools, this server is well-scoped for task management. It provides complete CRUD operations for tasks (create, get, update, delete, complete, list) plus project listing, which covers the essential workflows without being overwhelming or insufficient.
The tool surface provides complete coverage for task management. It includes all essential CRUD operations for tasks, plus task completion, project listing, and task listing within projects. There are no obvious gaps—agents can create, read, update, delete, complete, and list tasks, and navigate projects effectively.
Maintenance
Related MCP Connectors
Capture, clarify and plan your tasks from Claude or ChatGPT: inbox, next actions and projects.
Simple, fast todo app: manage tasks, projects and tags from Claude and other MCP clients.
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP Server for the Notion API, enabling Claude to interact with Notion workspaces.313,089 npm925MIT
- AlicenseBqualityDmaintenancePerform Asana operations from an MCP Client such as Anthropic's Claude Desktop Application, and many more.224,468 npm149MIT
- AlicenseBqualityDmaintenanceA TypeScript Model Context Protocol server that integrates with Google Tasks API, allowing users to create, list, update, delete, and toggle completion status of tasks.47MIT

Notion MCP Serverofficial
AlicenseBqualityCmaintenanceAn MCP server that enables AI assistants to interact with the Notion API, allowing them to search, read, comment on, and create content in Notion workspaces through natural language commands.19282,573 npm4,711MIT