🚀 Todoist MCP 服务器
Todoist MCP 服务器是一个集成了 Claude 与 Todoist 的 MCP（模型上下文协议）服务器实现。它允许用户通过日常用语来管理任务，让 Claude 能够使用自然语言与您的 Todoist 任务进行交互，极大地提升了任务管理的便捷性。
✨ 主要特性
- 自然语言任务管理：支持使用日常语言创建、更新、完成和删除任务，无需复杂的指令。
- 智能任务搜索：可通过部分名称匹配查找任务，快速定位所需任务。
- 灵活的过滤功能：能按截止日期、优先级和其他属性筛选任务，满足多样化的查询需求。
- 丰富的任务详情：支持描述、截止日期和优先级水平等详细信息的设置。
- 直观的错误处理：提供清晰的反馈，有效改善用户体验。
📦 安装指南
npm install -g @abhiz123/todoist-mcp-server
📚 详细文档
工具介绍
todoist_create_task
使用各种属性创建新任务：
- 必填项：内容（任务标题）
- 可选项：描述、截止日期、优先级水平（1 - 4）
- 示例：“创建任务‘团队会议’，附带说明‘每周同步’，设置为明天的任务”
todoist_get_tasks
检索并过滤任务：
- 按截止日期、优先级或项目筛选。
- 支持使用自然语言日期过滤。
- 结果限制可选。
- 示例：“显示此周的高优先级任务”
todoist_update_task
使用自然语言搜索更新现有任务：
- 通过部分名称匹配查找任务。
- 可更新任何任务属性（内容、描述、截止日期、优先级）。
- 示例：“将‘会议任务’设置为下周一截止”
todoist_complete_task
使用自然语言搜索标记任务完成：
- 使用名称查找并删除任务。
- 确认完成状态。
- 示例：“将‘文档任务’标记为已完成”
todoist_delete_task
使用自然语言搜索删除任务：
- 通过名称查找并删除任务。
- 显示确认消息。
- 示例：“删除‘代码审查任务’”
设置步骤
获取Todoist API令牌
- 登录到您的 Todoist 账户。
- 转到设置 → 集成。
- 在“开发者”部分找到 API 令牌。
与Claude Desktop一起使用
将以下内容添加到claude_desktop_config.json：
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "此处输入您的API令牌"
}
}
}
}
💻 使用示例
基础用法
# 创建任务
"创建任务‘团队会议’"
"添加任务‘审查PR’，设置为明天的任务"
"创建高优先级任务‘修复错误’，附带说明‘关键性能问题’"
# 获取任务
"显示所有我的任务"
"列出今天截止的任务"
"获取高优先级任务"
"显示此周的截止任务"
# 更新任务
"将文档任务设置为下周截止"
"更改错误修复任务的优先级为紧急"
"在团队会议任务中添加说明"
# 完成任务
"将PR审查任务标记为完成"
"完成文档任务"
# 删除任务
"删除代码审查任务"
"删除会议准备任务"
🔧 技术细节
从源码构建
# 克隆仓库
git clone https://github.com/abhiz123/todoist-mcp-server.git
# 进入目录
cd todoist-mcp-server
# 安装依赖项
npm install
# 构建项目
npm run build
🤝 贡献
欢迎贡献！随意提交 Pull Request。
📄 许可证
本项目在 MIT 许可证下发行——查看LICENSE文件获取详细信息。
❓ 问题与支持
如遇到任何问题或需要支持，请在GitHub 仓库提交问题。