Todoist MCP Server

🚀 Todoist MCP 服務端

一個集成 Claude 的 Todoist MCP（模型上下文協議）服務器實現，支持自然語言任務管理。該服務器允許 Claude 使用日常語言與您的 Todoist 任務交互。

🚀 快速開始

Todoist MCP 服務端是一個集成了 Claude 的服務器實現，可讓您使用自然語言進行任務管理，實現與 Todoist 任務的便捷交互。

✨ 主要特性

• 自然語言任務管理：使用日常語言創建、更新、完成和刪除任務。
• 智能任務搜索：通過部分名稱匹配查找任務。
• 靈活過濾：按截止日期、優先級和其他屬性篩選任務。
• 詳細的任務信息：支持描述、截止日期和優先級水平。
• 直觀的錯誤處理：提供清晰的反饋以改善用戶體驗。

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動安裝 Todoist MCP Server for Claude Desktop，可使用以下命令：

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

手動安裝

npm install -g @abhiz123/todoist-mcp-server

💻 使用示例

基礎用法

創建任務

todoist_create_task --content "完成項目報告" --description "包含所有最新數據的詳細報告"

獲取任務

todoist_get_tasks --due_date "2023-10-31"

更新任務

todoist_update_task --task_id 123 --priority_level 2

完成任務

todoist_complete_task --task_id 456

刪除任務

todoist_delete_task --task_id 789

高級用法

todoist_create_task

使用各種屬性創建新任務，示例："Create task 'Team Meeting' with description 'Weekly sync' due tomorrow" 。該命令中，content（任務標題）為必填項，description、due_date、priority_level（1 - 4）為可選。

todoist_get_tasks

檢索和篩選任務，可按截止日期、優先級或項目篩選，支持自然語言日期過濾，還可設置可選結果限制。示例："Show high priority tasks due this week" 。

todoist_update_task

使用自然語言搜索更新現有任務，通過部分名稱匹配查找任務，並可更新任何任務屬性（內容、描述、截止日期、優先級）。示例："Update meeting task to be due next Monday" 。

todoist_complete_task

使用自然語言搜索標記任務為完成，通過名稱查找並刪除任務，同時確認完成狀態。示例："Mark the documentation task as complete" 。

todoist_delete_task

使用自然語言搜索刪除任務，通過名稱查找並刪除任務，顯示確認消息。示例："Delete the PR review task" 。

📚 詳細文檔

設置

獲取 Todoist API Token

1. 登錄您的 Todoist 賬戶。
2. 導航到設置 → 集成。
3. 在“開發者”下找到您的 API 令牌。

與 Claude Desktop 使用

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_KEY": "your_api_key_here"
      }
    }
  }
}

開發信息

要貢獻到項目或進行開發，請參考 GitHub 倉庫。

貢獻指南

歡迎貢獻！請提交拉取請求或報告問題到 GitHub。

📄 許可證

項目遵循 MIT License。

問題支持

如遇問題，請訪問 GitHub Issues 或聯繫維護人員。