Todoist Mcp

Todoist MCP 服务

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

要求

• Node.js（推荐 v18 或更高版本）
• npm 或 yarn
• Todoist 账号
• Todoist API 令牌（参见 https://todoist.com/prefs/integrations）

功能

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

所有功能

• 任务：列出、获取、创建、更新、完成、重新打开、删除
• 项目：列出、获取、创建、更新、归档、取消归档、删除
• 分区：列出（按项目）、获取、创建、更新、删除
• 标签：列出、获取、创建、更新、删除、管理共享标签
• 评论：列出（按任务／项目）、获取、创建、更新、删除
• 协作者：列出项目协作者

安装

适用于 Claude Desktop（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"
         }
       }
     }
   }
   

使用示例

• 获取最高优先级任务：

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

• 创建并分类标签：

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

• 按分区整理任务：

  “将所有带有 ‘urgent’ 标签的任务移至 ‘Today’ 分区。”

• 项目管理：

  “创建一个名为 ‘Personal Growth’ 的新项目，并添加一个名为 ‘Reading List’ 的分区。”

• 协作者概览：

  “列出 ‘Team Launch’ 项目的所有协作者。”

• 评论管理：

  “为 ‘Prepare slides’ 任务添加评论，内容为 ‘Remember to include Q2 results.’”

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE。