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。