TaskMaster

🚀 TaskMaster: カーソル AI 向け Todoist MCP

Cursor AI向けに特別に開発された、Todoist連携用のモデルコンテキストプロトコル（MCP）サーバー実装です。このサーバーにより、Cursor AIアシスタントはコーディング環境からTodoistタスクを直接操作できるようになります。

デモビデオ

特徴

• 柔軟なタスクフィルタリング: Todoist の強力なフィルター構文を使用してタスクをフィルタリングします
  • 期日でフィルタリング: 今日、明日、期限超過
  • 優先度でフィルタリング（1～4、1が最高）
  • 複雑なクエリの組み合わせを使用してフィルタリングする
• 豊富なタスクフォーマット: 各タスクには、優先度、期限、その他の関連情報がわかりやすいアイコンで表示されます。
• Cursor AI 統合: Cursor AI コーディング環境内で Todoist をシームレスに使用できます

インストール

前提条件

• Python 3.10以上
• 詩（依存関係の管理用）
• TodoistアカウントとAPIトークン

設定

1. このリポジトリをクローンします:

2. 依存関係をインストールします:

3. Todoist API トークンを環境変数として設定します。

Todoist API トークンは、Todoist 設定 → 統合 → 開発者 で見つかります。

使用法

サーバーの実行

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" - 定期的な日付を持つタスク

カーソルAIの設定

Cursor AI で使用するには、MCP 構成ファイルを作成または編集します。

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

<username>とパスを実際のユーザー名とインストールへの正しいパスに置き換えます。

これを実行したら、「カーソル設定」→「MCP」に移動し、サーバーが正しく実行されていることを確認します (緑色の点)。

プロジェクト構造

コードベースはモジュールに編成されています:

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

ロードマップ

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

• タスク作成: Cursor AI から直接 Todoist に新しいタスクを追加します
• タスク完了: コンテキストを切り替えずにタスクを完了としてマークします
• タスクの削除: 不要になったタスクを削除します
• スマート タスク バランシング: 次の基準に基づいた AI を活用したタスクの再バランス調整:
  • プロジェクトの優先順位
  • 時間的なコミットメント
  • 期日
  • 現在の作業負荷
• プロジェクト管理: Todoist プロジェクトの作成と管理
• ラベルとフィルター: カスタムラベルを追加し、保存したフィルターを作成します

ライセンス

MITライセンス