🚀 Todoist MCP 服务端
一个集成 Claude 的 Todoist MCP（模型上下文协议）服务器实现，支持自然语言任务管理。该服务器允许 Claude 使用日常语言与您的 Todoist 任务交互。
🚀 快速开始
Todoist MCP 服务端是一个集成了 Claude 的服务器实现，可让您使用自然语言进行任务管理，实现与 Todoist 任务的便捷交互。
✨ 主要特性
- 自然语言任务管理：使用日常语言创建、更新、完成和删除任务。
- 智能任务搜索：通过部分名称匹配查找任务。
- 灵活过滤：按截止日期、优先级和其他属性筛选任务。
- 详细的任务信息：支持描述、截止日期和优先级水平。
- 直观的错误处理：提供清晰的反馈以改善用户体验。
📦 安装指南
通过 Smithery 安装
要通过 Smithery 自动安装 Todoist MCP Server for Claude Desktop，可使用以下命令：
npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude
手动安装
npm install -g @abhiz123/todoist-mcp-server
💻 使用示例
基础用法
创建任务
todoist_create_task --content "完成项目报告" --description "包含所有最新数据的详细报告"
获取任务
todoist_get_tasks --due_date "2023-10-31"
更新任务
todoist_update_task --task_id 123 --priority_level 2
完成任务
todoist_complete_task --task_id 456
删除任务
todoist_delete_task --task_id 789
高级用法
todoist_create_task
使用各种属性创建新任务，示例："Create task 'Team Meeting' with description 'Weekly sync' due tomorrow" 。该命令中，content（任务标题）为必填项，description、due_date、priority_level（1 - 4）为可选。
todoist_get_tasks
检索和筛选任务，可按截止日期、优先级或项目筛选，支持自然语言日期过滤，还可设置可选结果限制。示例："Show high priority tasks due this week" 。
todoist_update_task
使用自然语言搜索更新现有任务，通过部分名称匹配查找任务，并可更新任何任务属性（内容、描述、截止日期、优先级）。示例："Update meeting task to be due next Monday" 。
todoist_complete_task
使用自然语言搜索标记任务为完成，通过名称查找并删除任务，同时确认完成状态。示例："Mark the documentation task as complete" 。
todoist_delete_task
使用自然语言搜索删除任务，通过名称查找并删除任务，显示确认消息。示例："Delete the PR review task" 。
📚 详细文档
设置
获取 Todoist API Token
- 登录您的 Todoist 账户。
- 导航到设置 → 集成。
- 在“开发者”下找到您的 API 令牌。
与 Claude Desktop 使用
添加到 claude_desktop_config.json：
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_KEY": "your_api_key_here"
}
}
}
}
开发信息
要贡献到项目或进行开发，请参考 GitHub 仓库。
贡献指南
欢迎贡献！请提交拉取请求或报告问题到 GitHub。
📄 许可证
项目遵循 MIT License。
问题支持
如遇问题，请访问 GitHub Issues 或联系维护人员。