Todoist MCP Server

Todoist MCP 服务器

Todoist 的模型上下文协议 (MCP) 服务器，可通过 Claude Desktop 和其他兼容 MCP 的客户端实现高级任务和项目管理。

要求

• Node.js（建议使用 v18 或更高版本）
• npm 或 yarn
• Todoist 帐户
• Todoist API 令牌（请参阅https://todoist.com/prefs/integrations ）

特征

• 列出、创建、更新、完成、重新打开和删除任务
• 列出、创建、更新、存档、取消存档和删除项目
• 列出、创建、更新和删除部分
• 列出、创建、更新和删除标签
• 列出、创建、更新和删除评论
• 管理共享标签
• 获取项目合作者

所有功能

• 任务：列出、获取、创建、更新、完成、重新打开、删除
• 项目：列出、获取、创建、更新、存档、取消存档、删除
• 部分：列出（按项目）、获取、创建、更新、删除
• 标签：列出、获取、创建、更新、删除、管理共享标签
• 注释：列出（按任务/项目）、获取、创建、更新、删除
• 合作者：列出项目合作者

安装

对于 Claude 桌面 (JSON)

如果作为 npm 包发布，您可以在 Claude Desktop 配置中直接使用 npx 使用它：

• 按照所示设置TODOIST_API_TOKEN 。

手动安装

1. 克隆存储库：
   git clone https://github.com/yourusername/todoist-mcp.git cd todoist-mcp
2. 安装依赖项：
   npm install # or yarn install
3. 构建项目：
   npm run build # or yarn build
4. 将您的 Todoist API 令牌设置为环境变量（参见上文）。
5. 运行构建好的服务器：
   node dist/server.js
6. 通过将其添加到您的配置文件来配置 Claude Desktop 以使用您的本地构建：
   { "mcpServers": { "todoist": { "command": "node", "args": [ "/path/to/todoist-mcp/dist/server.js" ], "env": { "TODOIST_API_TOKEN": "your_todoist_token" } } } }

使用示例

• 获得最高优先级任务：

  “显示我的最优先任务。”

• 创建和分类标签：

  “为我的任务创建标签并按项目或紧急程度进行分类。”

• 按部分组织任务：

  “将所有带有‘紧急’标签的任务移至‘今天’部分。”

• 项目管理：

  “创建一个名为‘个人成长’的新项目，并添加‘阅读清单’部分。”

• 合作者概述：

  “列出项目‘团队启动’的所有合作者。”

• 评论管理：

  “在任务‘准备幻灯片’中添加一条评论，内容为‘记得包含第二季度结果’。”

执照

本项目遵循 MIT 许可证。详情请参阅许可证。