remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows Cursor AI assistants to interact with Todoist tasks, providing tools for task retrieval with powerful filtering options by due date, priority, and complex queries.

🚀 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トークン

設定

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

git clone https://github.com/mingolladaniele/todoist-mcp.git
cd todoist-mcp

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

pip install -r requirements.txt

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

カーソル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>とパスを実際のユーザー名とインストールへの正しいパスに置き換えます。

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

プロジェクト構造

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

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

ロードマップ

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

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

ライセンス

MITライセンス

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Cursor AI アシスタントがコーディング環境から直接 Todoist タスクを操作できるようにし、高度なタスクフィルタリングと豊富なフォーマットをサポートするモデルコンテキストプロトコルサーバーです。