Todoist TaskMaster

🚀 タスクマスター：Cursor AI 用 Todoist MCP

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" - 2024 年 5 月 5 日までの期限のタスク
• "due after: May 5" - 2024 年 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 を再起動します。これで Todoist タスクを使用できるはずです！

📚 詳細ドキュメント

プロジェクト構造

• api/ - API ラッパー
• config/ - 設定関連のファイル
• models/ - モデル関連のファイル
• tasks/ - タスク処理ロジック
• utils/ - ユーティリティ関数とヘルパー関数

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。