Todoist MCP 服务器
一个 MCP（模型上下文协议）服务器实现，将 Claude 与 Todoist 集成，实现自然语言任务管理。此服务器允许 Claude 使用日常语言与您的 Todoist 任务进行交互。
特征
- 自然语言任务管理：使用日常语言创建、更新、完成和删除任务
- 智能任务搜索：使用部分名称匹配查找任务
- 灵活过滤：按截止日期、优先级和其他属性过滤任务
- 丰富的任务详情：支持描述、截止日期和优先级
- 直观的错误处理：清晰的反馈以获得更好的用户体验
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Todoist MCP 服务器：
npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude
手动安装
npm install -g @abhiz123/todoist-mcp-server
工具
todoist_create_task
创建具有各种属性的新任务：
- 必填：内容（任务标题）
- 可选：描述、截止日期、优先级（1-4）
- 示例：“创建任务‘团队会议’，描述为‘每周同步’，明天截止”
todoist_get_tasks
检索和过滤任务：
- 按截止日期、优先级或项目进行过滤
- 自然语言日期过滤
- 可选结果限制
- 例如：“显示本周截止的高优先级任务”
todoist_update_task
使用自然语言搜索更新现有任务：
- 通过部分名称匹配查找任务
- 更新任何任务属性（内容、描述、截止日期、优先级）
- 例如：“更新下周一截止的会议任务”
todoist_complete_task
使用自然语言搜索将任务标记为完成：
- 通过部分名称匹配查找任务
- 确认完成状态
- 例如：“将文档任务标记为完成”
todoist_delete_task
使用自然语言搜索删除任务：
- 按名称查找和删除任务
- 确认消息
- 示例：“删除 PR 审核任务”
设置
获取 Todoist API 令牌
- 登录您的 Todoist 帐户
- 导航至“设置”→“集成”
- 在“开发者”下找到您的 API 令牌
与 Claude Desktop 一起使用
添加到您的claude_desktop_config.json ：
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "@abhiz123/todoist-mcp-server"],
"env": {
"TODOIST_API_TOKEN": "your_api_token_here"
}
}
}
}
示例用法
创建任务
"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"
获取任务
"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"
更新任务
"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"
完成任务
"Mark the PR review task as complete"
"Complete the documentation task"
删除任务
"Delete the PR review task"
"Remove meeting prep task"
发展
从源代码构建
# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git
# Navigate to directory
cd todoist-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。
问题与支持
如果您遇到任何问题或需要支持，请在GitHub 存储库上提交问题。