Todoist MCP 服务器

为 Todoist 提供的 Model Context Protocol (MCP) 服务器，支持通过 Claude Desktop 和其他 MCP 兼容客户端实现高级任务和项目管理。

需求

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

功能

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

所有功能

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

安装

用于 Claude Desktop（JSON）

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

{
  "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
   # 或
   yarn install
   

3. 构建项目：

   npm run build
   # 或
   yarn build
   

4. 设置你的 Todoist API 令牌作为环境变量（如上所示）。
5. 运行构建好的服务器：

   node dist/server.js
   

6. 在你的配置文件中添加此内容以使用本地构建：

   {
     "mcpServers": {
       "todoist": {
         "command": "node",
         "args": [
           "/path/to/todoist-mcp/dist/server.js"
         ],
         "env": {
           "TODOIST_API_TOKEN": "your_todoist_token"
         }
       }
     }
   }
   

使用示例

• 获取优先级最高的任务：

  "Show me my top priority tasks."

• 创建和分类标签：

  "Create labels for my tasks and classify them by project or urgency."

• 按部分整理任务：

  "Move all tasks with the label 'urgent' to the 'Today' section."

• 项目管理：

  "Create a new project called 'Personal Growth' and add a section 'Reading List'."

• 协作者概览：

  "List all collaborators for the project 'Team Launch'."

• 评论管理：

  "Add a comment to the task 'Prepare slides' with the content 'Remember to include Q2 results.'"

许可证

该项目采用 MIT License。详细信息请参见 LICENSE。