Taskmaster Todoist MCP

🚀 任務管理器：Todoist MCP for Cursor AI

這是一個專為Cursor AI開發的Todoist模型上下文協議（MCP）服務器實現。藉助此服務器，Cursor AI助手能夠直接在您的編碼環境中與您的Todoist任務進行交互，極大提升任務管理效率。

🚀 快速開始

您可以通過觀看下方的演示視頻，快速瞭解本任務管理器的使用方法：

✨ 主要特性

• 靈活的任務篩選：利用Todoist強大的過濾語法進行任務篩選。
  • 按截止日期篩選：支持“今天”“明天”“過期”等條件。
  • 按優先級水平篩選（1 - 4，其中1為最高優先級）。
  • 可使用複雜的查詢組合進行篩選。
• 豐富的任務格式化：每個任務會顯示優先級、截止日期和其他相關信息，並配有清晰的圖標，方便查看。
• Cursor AI集成：能夠在您的Cursor AI編碼環境中無縫使用Todoist，實現高效任務管理。

📦 安裝指南

先決條件

• Python 3.10或更高版本
• Poetry（用於依賴管理）
• Todoist賬戶和API令牌

設置步驟

1. 克隆此倉庫：

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

2. 安裝依賴項：

pip install -r requirements.txt

3. 將Todoist API令牌設置為環境變量：

# Linux/macOS
export TODOIST_API_TOKEN="your-api-token-here"

# Windows
set TODOIST_API_TOKEN="your-api-token-here"

您可以在Todoist設置 → 集成 → 開發人員中找到您的Todoist API令牌。

💻 使用示例

運行服務器

python server.py

MCP工具

該服務器提供以下MCP工具：

get_tasks_tool

使用強大的過濾選項獲取任務。

參數：

• filter_string：複雜的Todoist過濾查詢字符串
• priority：可選的優先級水平（1 - 4，其中1為最高優先級）

示例過濾字符串：

• "today" - 今天截止的任務
• "overdue" - 過期的任務
• "Jan 3" - 2024年1月3日截止的任務
• "due before: May 5" - 截止日期在May 5之前的所有任務
• "due after: May 5" - 截止日期在May 5之後的所有任務
• "due before: +4 hours" - 在接下來的四小時內到期的所有任務以及所有過期的任務
• "no date" - 沒有截止日期的任務
• "5 days" 或 "next 5 days" - 接下來五天內截止的任務
• "recurring" - 具有重複截止日期的任務

與Cursor AI一起使用

要與Cursor AI一起使用，請創建或編輯MCP配置文件：

Windows：C:\Users\<username>\.cursor\mcp.json

{
  "mcpServers": {
    "todoist-mcp": {
      "command": "C:/Users/<username>/path/to/todoist-mcp/.venv/Scripts/python.exe",
      "args": [
        "server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

請將<username>替換為您的實際用戶名，並將path/to/todoist-mcp替換為實際安裝路徑。

📚 詳細文檔

項目結構

• api/ - 包含與Todoist API交互的代碼
• tasks/ - 包含任務邏輯和處理程序
• server.py - 主服務器文件
• requirements.txt - 項目的依賴項列表
• README.md - 項目說明文檔

未來計劃

• 添加任務創建功能
• 實現任務完成功能
• 支持任務刪除操作
• 增加對任務優先級的完全支持
• 提供更復雜的過濾選項

📄 許可證

該項目使用MIT許可證。