Dida MCP Server

基本能力

产品定位

Dida MCP Server 是一个任务管理服务，旨在通过 MCP 框架与 TickTick/Dida365 账户交互，帮助用户高效管理任务和项目。

核心功能

• 认证：支持 OAuth 和用户名/密码两种认证方式
• 任务管理：创建、读取、更新、删除和移动任务
• 项目管理：创建、读取、更新和删除项目
• 批量操作：支持批量更新、删除和移动任务
• GTD 助手：内置基于 GTD 原则的任务组织系统提示
• 数据缓存：高效缓存项目和标签数据

适用场景

• 个人任务管理
• 团队协作任务分配
• GTD 方法论实践

工具列表

• 认证工具：check-auth-status
• 项目管理工具：list-projects, create-project, update-project, delete-project, refresh-project-cache
• 任务管理工具：list-tasks, create-task, get-task, update-task, batch-update-tasks, complete-task, delete-task, batch-delete-tasks, move-task, batch-move-tasks
• 数据查询工具：list-cached-data

常见问题解答

1. 认证失败：确保已正确配置 Client ID 和 Client Secret
2. 缓存数据过期：使用 refresh-project-cache 手动刷新缓存
3. API 限制：注意 TickTick/Dida365 API 的调用频率限制

使用教程

使用依赖

• Node.js (v16 或更高版本)
• npm (v7 或更高版本)
• TickTick/Dida365 账户
• 从 Dida365 Developer Center 获取 Client ID 和 Client Secret

安装教程

从 npm 安装（推荐）

# 全局安装
npm install -g dida-mcp-server

# 或本地安装
npm install dida-mcp-server

从源码安装

git clone https://github.com/zhongwencool/dida-mcp-server.git
cd dida-mcp-server
npm install
npm run build

调试方式

启动服务器

# 全局安装
mcp-server

# 本地安装
npm start

开发模式

npm run dev

运行测试

npm test

许可证

该项目遵循 ISC 开源许可条款，请参阅 ISC 了解完整条款。