Todoist MCP 服务器扩展

这是一个实现了 MCP（Model Context Protocol）协议的服务器，它将 Claude 或任何其他兼容 MCP 的 LLM（如果你足够聪明的话）与 Todoist 集成起来，通过 MCP 工具实现自然语言任务管理。此服务器中的工具允许 Claude 使用日常语言与你的 Todoist 任务、项目、部分和标签进行交互，同时优化了 LLM 工作流效率。

功能概览

• 任务管理：使用日常语言创建、更新、完成和删除任务
• 标签管理：创建、更新和个人标签及任务标签的管理
• 项目管理：创建、更新和管理 Todoist 项目
• 部分组织：在项目内创建和管理部分
• 智能搜索：通过部分名称匹配查找任务和标签
• 灵活过滤：按项目、部分、截止日期、优先级和标签筛选任务
• 丰富的任务详情：支持描述、截止日期、优先级级别以及项目/部分分配
• 批量操作：工具内置批量操作支持和自定义参数，以高效地配合 LLM 工作流程使用

有关可用工具及其使用的完整列表，请参阅 tools.md。

快速安装指南

假设你已经安装了 npm。

更详细的安装指南可以在 How-to Guide 中找到。

通过 Smithery 安装

要通过 Smithery 为 Claude 桌面版安装 Todoist MCP 服务器扩展：

1. 在 cmd\pwsh 中运行以下命令：

    npx -y @smithery/cli install @Chrusic/todoist-mcp-server-extended --client claude

也兼容 cline 或 windsurf，只需将最后一个参数改为 --client cline 或 --client windsurf 即可

通过 npm 安装

1. 在 cmd\pwsh 中运行以下命令：

    npm install -g @chrusic/todoist-mcp-server-extended

设置

获取 Todoist API 令牌

1. 登录到你的 Todoist 账户
2. 导航至 设置 → 集成
3. 在 开发者 下找到你的 API 令牌
4. 点击 复制 API 令牌

有关 Todoist API 的更多信息，请访问 官方 Todoist API 文档。

添加 MCP 服务器和 API 令牌到 Claude 桌面客户端

1. 在你的 claude_desktop_config.json 文件中，将以下 JSON 代码片段粘贴到 "mcpServers":{ }: 之间：

   "todoist": {
     "command": "npx",
     "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
     "env": {
         "TODOIST_API_TOKEN": "在此处粘贴您的 API 令牌"
     }
   }
   

2. 当所有内容组合在一起时，它应该看起来像这样：

   {
   "mcpServers": {
       "todoist": {
       "command": "npx",
       "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
       "env": {
           "TODOIST_API_TOKEN": "在此处粘贴您的 API 令牌"
       }
       }
   }
   }
   

3. 接下来，在下次启动（或重新启动）客户端时，Claude Desktop 客户端将启动 MCP 服务器并加载工具。

使用示例

这里有一些关于如何向 Claude 提问的简单建议。请注意，有时您需要非常直接地指示 Claude 使用这些工具：

• "使用 MCP 工具：todoist_get_tasks，列出我今天的所有任务。"
• "在项目 'Work' 的 'To Do' 部分创建一个名为 'Review PR' 的任务。"
• "为任务 'Review PR' 添加标签 'Important'。"
• "显示项目 'Work' 中带有标签 'Important' 的所有任务。"
• "将任务 'Documentation' 移至 'In Progress' 部分。"
• "将文档任务标记为已完成。"
• "给我一些建议，列出一些我今天可以做的任务，因为我打算进城购物。"
• "将任务 X 分解成更小的子任务，并添加截止日期 x, y, z。"

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

问题和支持

如果您遇到任何问题或需要支持，请在 GitHub 仓库 上提交问题。