Todoist MCP

🚀 Todoist MCP 服务器

Todoist MCP 服务器为 Todoist 提供了 Model Context Protocol (MCP) 支持，借助该服务器，Claude Desktop 及其他 MCP 兼容客户端能够实现高级任务与项目管理，极大提升管理效率。

🚀 快速开始

Todoist MCP 服务器可助力你通过 Claude Desktop 等 MCP 兼容客户端，对 Todoist 进行高级任务和项目管理。使用前，请确保满足以下需求：

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

✨ 主要特性

任务管理

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

项目管理

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

部分管理

• 支持按项目列出、获取、创建、更新和删除部分（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 令牌设置为环境变量（如上述 JSON 配置所示）。
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。