金大哥 - todoist-mcp MCP 详情

article

README

🚀 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。

手动安装

克隆仓库：

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

安装依赖项：

npm install
# 或
yarn install

构建项目：

npm run build
# 或
yarn build

将你的 Todoist API 令牌设置为环境变量（如上述 JSON 配置所示）。
运行构建好的服务器：

node dist/server.js

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

{
  "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。

todoist-mcp