Abhiz123 Todoist MCP Server

🚀 Todoist MCP 服務器

Todoist MCP 服務器是一個集成了 Claude 與 Todoist 的 MCP（模型上下文協議）服務器實現。它允許用戶通過日常用語來管理任務，讓 Claude 能夠使用自然語言與您的 Todoist 任務進行交互，極大地提升了任務管理的便捷性。

✨ 主要特性

• 自然語言任務管理：支持使用日常語言創建、更新、完成和刪除任務，無需複雜的指令。
• 智能任務搜索：可通過部分名稱匹配查找任務，快速定位所需任務。
• 靈活的過濾功能：能按截止日期、優先級和其他屬性篩選任務，滿足多樣化的查詢需求。
• 豐富的任務詳情：支持描述、截止日期和優先級水平等詳細信息的設置。
• 直觀的錯誤處理：提供清晰的反饋，有效改善用戶體驗。

📦 安裝指南

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

📚 詳細文檔

工具介紹

todoist_create_task

使用各種屬性創建新任務：

• 必填項：內容（任務標題）
• 可選項：描述、截止日期、優先級水平（1 - 4）
• 示例：“創建任務‘團隊會議’，附帶說明‘每週同步’，設置為明天的任務”

todoist_get_tasks

檢索並過濾任務：

• 按截止日期、優先級或項目篩選。
• 支持使用自然語言日期過濾。
• 結果限制可選。
• 示例：“顯示此周的高優先級任務”

todoist_update_task

使用自然語言搜索更新現有任務：

• 通過部分名稱匹配查找任務。
• 可更新任何任務屬性（內容、描述、截止日期、優先級）。
• 示例：“將‘會議任務’設置為下週一截止”

todoist_complete_task

使用自然語言搜索標記任務完成：

• 使用名稱查找並刪除任務。
• 確認完成狀態。
• 示例：“將‘文檔任務’標記為已完成”

todoist_delete_task

使用自然語言搜索刪除任務：

• 通過名稱查找並刪除任務。
• 顯示確認消息。
• 示例：“刪除‘代碼審查任務’”

設置步驟

獲取Todoist API令牌

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

與Claude Desktop一起使用

將以下內容添加到claude_desktop_config.json：

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "此處輸入您的API令牌"
      }
    }
  }
}

💻 使用示例

基礎用法

# 創建任務
"創建任務‘團隊會議’"
"添加任務‘審查PR’，設置為明天的任務"
"創建高優先級任務‘修復錯誤’，附帶說明‘關鍵性能問題’"

# 獲取任務
"顯示所有我的任務"
"列出今天截止的任務"
"獲取高優先級任務"
"顯示此周的截止任務"

# 更新任務
"將文檔任務設置為下週截止"
"更改錯誤修復任務的優先級為緊急"
"在團隊會議任務中添加說明"

# 完成任務
"將PR審查任務標記為完成"
"完成文檔任務"

# 刪除任務
"刪除代碼審查任務"
"刪除會議準備任務"

🔧 技術細節

從源碼構建

# 克隆倉庫
git clone https://github.com/abhiz123/todoist-mcp-server.git

# 進入目錄
cd todoist-mcp-server

# 安裝依賴項
npm install

# 構建項目
npm run build

🤝 貢獻

歡迎貢獻！隨意提交 Pull Request。

📄 許可證

本項目在 MIT 許可證下發行——查看LICENSE文件獲取詳細信息。

❓ 問題與支持

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