Todoist MCP 服务器

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

要求

• Node.js（建议使用 v18 或更高版本）

• npm 或 yarn

• Todoist 帐户

• Todoist API 令牌（请参阅https://todoist.com/prefs/integrations ）

Related MCP server: Todoist Python MCP Server

特征

• 列出、创建、更新、完成、重新打开和删除任务

• 列出、创建、更新、存档、取消存档和删除项目

• 列出、创建、更新和删除部分

• 列出、创建、更新和删除标签

• 列出、创建、更新和删除评论

• 管理共享标签

• 获取项目合作者

所有功能

• 任务：列出、获取、创建、更新、完成、重新打开、删除

• 项目：列出、获取、创建、更新、存档、取消存档、删除

• 部分：列出（按项目）、获取、创建、更新、删除

• 标签：列出、获取、创建、更新、删除、管理共享标签

• 注释：列出（按任务/项目）、获取、创建、更新、删除

• 合作者：列出项目合作者

安装

对于 Claude 桌面 (JSON)

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

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_token"
      }
    }
  }
}

• 按照所示设置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 许可证。详情请参阅许可证。