Todoist MCP Server

基本能力

产品定位

Todoist MCP Server 是一个任务和项目管理工具，通过 MCP 协议与 Todoist 集成，提供丰富的 API 功能，支持任务、项目、标签、评论等的全面管理。

核心功能

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

适用场景

• 个人任务管理：管理日常任务，设置优先级，分类标签。
• 团队项目管理：创建项目，管理分区，分配任务，查看协作者。
• 任务自动化：通过 API 自动创建、更新任务，添加评论。
• 高级分类：使用标签和分区对任务进行高级分类和组织。

使用教程

使用依赖

• Node.js (v18 或更高版本推荐)
• npm 或 yarn
• Todoist 账户
• Todoist API token (从 https://todoist.com/prefs/integrations 获取)

安装教程

通过 npm 安装

1. 在 Claude Desktop 配置中添加以下内容：

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

手动安装

1. 克隆仓库：

git clone https://github.com/yourusername/todoist-mcp.git
cd todoist-mcp

1. 安装依赖：

npm install
# 或
yarn install

1. 构建项目：

npm run build
# 或
yarn build

1. 设置 Todoist API token 环境变量：

export TODOIST_API_TOKEN="your_todoist_token"

1. 运行服务器：

node dist/server.js

1. 在 Claude Desktop 配置中添加本地服务器路径：

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

调试方式

1. 确保服务器正在运行：

node dist/server.js

1. 使用 Claude Desktop 或其他 MCP 客户端发送请求，例如：
2. "Show me my top priority tasks."
3. "Create labels for my tasks and classify them by project or urgency."
4. "Move all tasks with the label 'urgent' to the 'Today' section."
5. "Create a new project called 'Personal Growth' and add a section 'Reading List'."
6. "List all collaborators for the project 'Team Launch'."
7. "Add a comment to the task 'Prepare slides' with the content 'Remember to include Q2 results.'"

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。