Dida365 MCP Server
Allows managing projects and tasks on TickTick (Dida365), including creating, updating, deleting, and searching tasks, as well as managing project lists and filtering by priority or due date.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Dida365 MCP Server 帮我看看今天有哪些高优先级的任务"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
dida-mcp 🦞✅
滴答清单 (Dida365) MCP Server — 让 AI 助手控制你的滴答清单。
🎯 首个支持中国版滴答清单 (dida365.com) 的 MCP Server,13 个 AI 工具覆盖任务、项目、标签管理。
适用于 OpenClaw (龙虾)、Claude Desktop、CodeBuddy 以及任何支持 MCP 协议的 AI 客户端。
✨ 功能
类别 | 工具 | 说明 |
📁 项目管理 |
| 列出所有项目(清单) |
| 查看项目详情及其任务 | |
| 创建新项目 | |
| 删除项目 | |
✅ 任务管理 |
| 获取所有未完成任务 |
| 创建新任务 | |
| 更新任务信息 | |
| 标记任务完成 | |
| 删除任务 | |
🔍 高级查询 |
| 今天到期的任务 |
| 所有逾期任务 | |
| 按优先级筛选 | |
| 关键词搜索 |
Related MCP server: Dida365 MCP Server
🚀 快速开始
1. 创建滴答清单应用
创建一个新应用
记下 Client ID 和 Client Secret
设置 OAuth Redirect URL 为
http://localhost:18090/callback
2. 安装
git clone https://github.com/Martinqi826/dida-mcp.git
cd dida-mcp
pip install -e .3. 配置
cp .env.example .env编辑 .env,填入你自己的凭据:
DIDA_CLIENT_ID=你的_Client_ID
DIDA_CLIENT_SECRET=你的_Client_Secret
DIDA_REDIRECT_URI=http://localhost:18090/callback4. 授权
dida-mcp auth浏览器会自动打开,登录你的滴答清单账号并授权。成功后 Token 会保存到 ~/.dida-mcp/token.json。
5. 验证
dida-mcp test看到 ✅ API 连接成功! 就说明一切就绪。
🦞 配置到 OpenClaw(龙虾)
OpenClaw 目前不原生支持 MCP Server 注入,需要通过 mcporter 桥接。
第一步:安装 mcporter
npm install -g mcporter第二步:注册 dida-mcp 到 mcporter
mcporter add dida-mcp \
--command "dida-mcp" \
--args "run" \
--env DIDA_CLIENT_ID=你的_Client_ID \
--env DIDA_CLIENT_SECRET=你的_Client_Secret \
--env DIDA_REDIRECT_URI=http://localhost:18090/callback或者手动编辑 ~/.mcporter/mcporter.json:
{
"mcpServers": {
"dida-mcp": {
"command": "dida-mcp",
"args": ["run"],
"description": "滴答清单 MCP Server",
"env": {
"DIDA_CLIENT_ID": "你的_Client_ID",
"DIDA_CLIENT_SECRET": "你的_Client_Secret",
"DIDA_REDIRECT_URI": "http://localhost:18090/callback"
}
}
}
}第三步:启用 mcporter skill
确认 ~/.openclaw/openclaw.json 中有:
{
"skills": {
"entries": {
"mcporter": {
"enabled": true
}
}
}
}第四步:添加工具说明到 TOOLS.md
将 openclaw/TOOLS.md 的内容追加到 ~/.openclaw/workspace/TOOLS.md 中。
这一步很关键——OpenClaw AI 会在启动时读取 TOOLS.md,从而知道可以通过 mcporter call dida-mcp.* 来操作你的滴答清单。
第五步:重启 Gateway 并验证
openclaw gateway restart在 OpenClaw 中开一个新对话,输入:
帮我看看我的滴答清单有哪些项目AI 就会调用 mcporter call dida-mcp.get_projects 并返回结果。
🤖 配置到 Claude Desktop / CodeBuddy
在 MCP 配置文件中添加:
{
"mcpServers": {
"dida-mcp": {
"command": "dida-mcp",
"args": ["run"],
"env": {
"DIDA_CLIENT_ID": "你的_Client_ID",
"DIDA_CLIENT_SECRET": "你的_Client_Secret"
}
}
}
}💬 使用示例
配置完成后,你可以对 AI 说:
🗂️ "帮我看看我的滴答清单有哪些项目"
✅ "创建一个新任务:明天下午3点和客户开会,优先级高"
✔️ "把'写周报'标记为完成"
🔍 "搜索包含'会议'的任务"
📁 "创建一个叫'工作'的新项目"
⚠️ "我有哪些逾期任务?"
🔺 "列出所有高优先级任务"
📅 "今天有什么到期的?"
📖 CLI 命令
命令 | 说明 |
| OAuth 授权(首次使用必须执行) |
| 测试 API 连接 |
| 启动 MCP Server(stdio 模式) |
| 查看认证状态 |
| 清除本地 token |
🔧 项目结构
dida-mcp/
├── pyproject.toml # 项目配置
├── LICENSE # MIT 许可证
├── README.md # 本文档
├── .env.example # 环境变量示例
├── .gitignore # Git 忽略规则
├── openclaw/
│ └── TOOLS.md # OpenClaw TOOLS.md 参考内容
└── src/
└── dida_mcp/
├── __init__.py # 包初始化
├── auth.py # OAuth 2.0 认证模块
├── client.py # 滴答清单 API 客户端
├── server.py # MCP Server 实现 (JSON-RPC over stdio)
└── cli.py # 命令行工具⚠️ 注意事项
本项目使用滴答清单中国版(dida365.com)的 Open API
国际版 TickTick 用户需自行修改 API 地址(
ticktick.com)Access Token 存储在
~/.dida-mcp/token.json,请妥善保管请勿将
.env文件提交到 git,你的 Client Secret 是私密的删除项目或任务的操作不可恢复
优先级数值:
0=无、1=低、3=中、5=高日期格式为 ISO 8601,如
2026-03-15T09:00:00+0800
🤝 Contributing
欢迎提交 Issue 和 PR!
Fork 本仓库
创建特性分支 (
git checkout -b feature/awesome)提交更改 (
git commit -m 'Add awesome feature')推送到分支 (
git push origin feature/awesome)创建 Pull Request
📄 License
Available Tools
13 toolscomplete_taskB
将指定任务标记为已完成。需要提供 task_id 和 project_id。
Inputs: task_id (required), project_id (required).
create_projectC
创建新的项目(清单)。
Inputs: name (required), color.
create_taskA
创建新任务。可以指定标题、所属项目、截止日期、优先级、标签等。不指定项目则放入收集箱。
Inputs: title (required), tags, content, due_date, +4 more.
delete_projectA
删除指定的项目(清单)。⚠️ 此操作不可恢复。
Inputs: project_id (required).
delete_taskA
删除指定任务。⚠️ 此操作不可恢复。需要提供 task_id 和 project_id。
Inputs: task_id (required), project_id (required).
get_all_tasksB
获取所有未完成的任务列表,包含任务的标题、截止日期、优先级、所属清单等信息。
Inputs: no named parameters.
get_overdue_tasksB
获取所有已过期(逾期)的任务。
Inputs: no named parameters.
get_project_detailA
获取指定项目的详细信息及其所有任务。
Inputs: project_id (required).
get_projectsA
获取所有项目(清单)列表。返回所有项目的名称、ID、颜色等信息。
Inputs: no named parameters.
get_tasks_by_priorityC
按优先级获取任务。
Inputs: priority (required).
get_tasks_due_todayB
获取今天到期的所有任务。
Inputs: no named parameters.
search_tasksA
搜索任务。可以按标题、内容、标签进行模糊搜索。
Inputs: query (required).
update_taskB
更新已有任务的信息,如标题、截止日期、优先级等。需要提供 task_id 和 project_id。
Inputs: task_id (required), project_id (required), tags, title, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
每个工具都有明确且独特的用途:创建、删除、更新、完成任务,以及多种查询(全部、逾期、按优先级、今天到期、搜索),没有功能重叠,区分清晰。
所有工具名称均采用一致的动词_名词模式(如create_project、delete_task、get_all_tasks),全部使用小写和下划线,命名风格统一。
13个工具数量适中,全面覆盖任务管理核心操作(项目CRUD、任务CRUD及多种过滤查询),没有冗余或不足。
覆盖了任务和项目的基本CRUD及常见查询,但缺少更新项目功能和直接按ID获取单个任务详情,存在轻微功能缺口。
Maintenance
Related MCP Connectors
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Create and manage MeisterTask projects, tasks, and notes from your AI assistant.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Dida365 (滴答清单) tasks through the Model Context Protocol. It supports full task lifecycle management including creating, updating, and filtering tasks with automatic timezone handling.11 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to directly manage Dida365 (TickTick) tasks, including creating, editing, completing, and setting priorities, deadlines, subtasks, reminders, and recurring tasks via natural language.8MIT
- AlicenseBqualityFmaintenanceMCP server that enables AI agents to manage Dida365/TickTick tasks, projects, tags, and habits through natural language, with full CRUD, search, and advanced V2 capabilities.1923 PyPI2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage TickTick/Dida365 tasks, projects, and tags through the MCP protocol, with features for GTD-based task organization and OAuth authentication.14 npm10ISC