Todoist

🚀 Todoist MCP 服務器

Todoist MCP 服務器是一個與 Todoist 整合的 Model Context Protocol (MCP) 服務器實現，它能讓 Claude 和其他 AI 助手通過自然語言進行任務管理，為任務管理帶來了極大的便利。

🚀 快速開始

你需要一個 Todoist API 令牌來使用此 MCP 服務器。

獲取 Todoist API 令牌

1. 登錄到你的 Todoist 賬戶。
2. 進入設置 → 集成。
3. 在“開發者”部分找到你的 API 令牌。

與 Claude Desktop 使用

添加到你的 claude_desktop_config.json：

{
    "mcpServers": {
        "todoist": {
            "command": "npx",
            "args": ["-y", "todoist-mcp"],
            "env": {
                "API_KEY": "your_todoist_api_token_here"
            }
        }
    }
}

✨ 主要特性

• 完整的 Todoist API 集成：支持 Todoist REST API v2 和通過自然語言的 Todoist 同步 API。
• 批量處理：客戶端可以一次請求處理多個任務。
• 按名稱搜索：AI 可以通過名稱搜索任務、項目和標籤，而無需 ID。
• 任務管理：創建、更新、關閉、重新打開、移動和刪除任務，使用自然語言即可。
• 項目管理：創建和管理項目和部分。
• 評論功能：添加和管理任務和項目上的評論。
• 標籤管理：創建和管理個人和共享標籤。
• 提示支持：你可以輕鬆地為客戶端提供項目信息。

📦 安裝指南

# 安裝項目
npm install

# 構建項目並運行 inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

💻 使用示例

基礎用法

# 安裝項目
npm install

# 構建項目並運行 inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

📚 詳細文檔

可用工具

任務管理

• get_tasks_list：獲取任務列表，可選按項目、部分、標籤等過濾。
• create_tasks：創建新任務，帶有各種屬性。
• get_tasks：通過 ID 或名稱獲取特定任務。
• update_tasks：更新現有任務。
• close_tasks：關閉任務。
• reopen_tasks：重新打開任務。
• move_task：移動任務。

項目管理

• create_project：創建新項目。
• get_projects：獲取所有項目。
• get_project：通過 ID 獲取特定項目。
• update_project：更新現有項目。
• delete_project：刪除項目。

標籤管理

• create_label：創建新標籤。
• get_labels：獲取所有標籤。
• get_label：通過 ID 獲取特定標籤。
• update_label：更新現有標籤。
• delete_label：刪除標籤。

📄 許可證

此項目使用 MIT 許可證，詳細信息請查看 LICENSE 文件。

問題與支持

如果你遇到任何問題或需要支持，請在 GitHub 倉庫中提交問題。