Todoist MCP Server

这是一个用于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
   # 或
   yarn install
   

3. 构建项目：

   npm run build
   # 或
   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"
         }
       }
     }
   }
   

使用示例

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

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

• 创建并分类标签：

  "为我的任务创建标签，并根据项目或紧急程度进行分类。"

• 按部分组织任务：

  "将带有'紧急'标签的所有任务移动到'Today'部分。"

• 项目管理：

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

• 协作者概览：

  "列出项目'Team Launch'的所有协作者。"

• 评论管理：

  "在任务'准备幻灯片'上添加一条评论，内容为'记得包括Q2结果'。"

许可证

本项目采用MIT许可证。详情请参阅LICENSE。 </中文翻译>