🚀 TaskMaster: Todoist MCP for Cursor AI

🚀 TaskMaster：Cursor AI 向け Todoist MCP

Todoist と連携する Model Context Protocol（MCP）サーバーの実装です。特に Cursor AI 向けに開発されています。このサーバーを使うと、Cursor AI アシスタントがコーディング環境から Todoist のタスクを直接操作できます。

デモ動画

機能

• 柔軟なタスクの絞り込み：Todoist の強力なフィルター構文を使ってタスクを絞り込めます
  • 期限で絞り込み：今日、明日、期限超過
  • 優先度で絞り込み（1〜4。1 が最高）
  • 複雑なクエリの組み合わせによる絞り込み
• 見やすいタスク表示：各タスクの優先度、期限、その他の関連情報を分かりやすいアイコンとともに表示します
• Cursor AI との連携：Cursor AI のコーディング環境で Todoist をシームレスに利用できます

インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop に TaskMaster を自動的にインストールするには：

npx -y @smithery/cli install @mingolladaniele/taskMaster-todoist-mcp --client claude

前提条件

• 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" - 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": [
        "C:/Users/<username>/path/to/todoist-mcp/server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

<username> とパスを、実際のユーザー名とインストール先の正しいパスに置き換えてください。

設定後、Cursor Settings → MCP に移動し、サーバーが正しく実行されていること（緑色の点）を確認してください。

プロジェクト構成

コードベースは、次のモジュールで構成されています：

• api/：Todoist 用 API ラッパー
• config/：設定と構成
• utils/：タスクのフォーマットを含むユーティリティ関数とヘルパー

ロードマップ

今後のリリースで予定されている機能は次のとおりです：

• タスクの作成：Cursor AI から Todoist に新しいタスクを追加
• タスクの完了：作業の流れを中断せずにタスクを完了としてマーク
• タスクの削除：不要になったタスクを削除
• スマートなタスクのバランス調整：次の要素に基づき、AI を活用してタスクのバランスを調整：
  • プロジェクトの優先度
  • 時間の制約
  • 期限
  • 現在の作業量
• プロジェクト管理：Todoist のプロジェクトを作成、管理
• ラベルとフィルター：カスタムラベルの追加と保存済みフィルターの作成

ライセンス

MIT License