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 APIトークンは、Todoistの設定 → 統合 → 開発者で見つけることができます。

💻 使用例

サーバーの起動

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" - 5月5日より前に期限のあるすべてのタスク
• "due after: May 5" - 5月5日より後に期限のあるすべてのタスク
• "due before: +4 hours" - 次の4時間以内に期限のあるすべてのタスクと期限切れのタスク
• "no date" - 期限のないタスク
• "5 days" または "next 5 days" - 次の5日以内に期限のあるタスク
• "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ライセンスの下で提供されています。