Todoist TaskMaster

🚀 任務大師：Todoist MCP 對於 Cursor AI

任務大師是專為 Cursor AI 開發的 Todoist 模型上下文協議（MCP）服務器實現。它允許 Cursor AI 助手直接在編程環境中與您的 Todoist 任務進行交互，極大提升任務管理效率。

🚀 快速開始

本項目旨在讓您在 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" - 在 2024 年 5 月 5 日之前截止的任務
• "due after: May 5" - 在 2024 年 5 月 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": [
        "C:/Users/<username>/path/to/todoist-mcp/server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

替換 <username> 為您實際的用戶名。完成編輯後，保存文件並重新啟動 Cursor，即可使用 Todoist 任務。

📚 詳細文檔

項目結構

• api/ - API 包裹器
• config/ - 配置與設置
• models/ - 模型相關文件
• tasks/ - 任務處理邏輯
• utils/ - 工具和輔助函數

📄 許可證

此項目使用 MIT 許可證。

演示視頻