Todoist MCP サーバー

ClaudeのようなクライアントがTodoistと対話し、自然言語によるタスク管理機能を実現するModel Context Protocol（MCP）サーバー。このサーバーはクライアントとTodoist APIの仲介役として機能し、認証、データ変換、コマンド処理を行います。これはPythonバージョンです。

特徴

タスク作成: 必要なコンテンツとオプションの属性を持つ新しいタスクを作成します
タスクの取得: IDでタスクを取得、またはフィルタリングオプションを使用してタスクを一覧表示します
タスク管理: タスク属性の更新、タスクを完了としてマーク、タスクの削除

前提条件

Python 3.12
紫外線
TodoistアカウントとAPIトークン

Todoist APIトークンの取得方法

Todoistアカウントにログイン
ユーザー設定 -> 統合 -> 開発者に移動します
APIトークンをコピー

Claude Desktopでの使用

UVX経由で実行（クローンなし）

UVX を使用して GitHub から直接サーバーを実行できます。

uvx --from https://github.com/Johnxjp/todoist-mcp-python.git mcp-server-todoist

次に、この構成を Claude 設定に追加します。

{
  "mcpServers": {
    "todoist-server": {
      "command": "uvx",
      "args": [
        "--from", 
        "https://github.com/Johnxjp/todoist-mcp-python.git", 
        "mcp-server-todoist"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

クローンしたリポジトリから実行

リポジトリのクローンを作成する場合は、次のコマンドを使用します。

git clone git@github.com:Johnxjp/todoist-mcp-python.git

次に、Claude 構成ファイルに以下を追加します。

{
  "mcpServers": {
    "todoist-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "todoist_api_python",
        "mcp",
        "run",
        "/full/path/to/todoist_server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

利用可能なツール

サーバーは、Claude が使用できる次のツールを提供します。

create_task : Todoistで新しいタスクを作成する
- 必須: コンテンツ（タスクのタイトル）
- オプション:
  - 説明、
  - 期日、
  - 優先度、
  - プロジェクトID、
  - セクションID、
  - ラベル
get_tasks : さまざまなフィルターを使用して Todoist からタスクと ID のリストを取得します。
- オプション:
  - プロジェクトID、
  - プロジェクト名、
  - タスク名、
  - 優先度、
  - ラベル、
  - 期限超過、
  - 制限
update_task : 既存のタスクを名前で検索して更新する
- 必須: タスクID
- オプション:
  - コンテンツ、
  - 説明、
  - ラベル、
  - 優先度、
  - 期日（YYYY-MM-DD）
  - 締め切り日（YYYY-MM-DD）
delete_task : 名前で検索してタスクを削除する
- 必須: タスクID
complete_task : タスクを名前で検索して完了としてマークします
- 必須: タスクID

やり取りの例

Claude がこの MCP サーバーを介して Todoist とやり取りする方法の例をいくつか示します。

「食料品を買うタスクを追加」
「緊急のタスクをすべて表示」
「今日期限が迫っているタスクは何ですか？」
「洗濯タスクを完了としてマークする」
「歯医者の予約の優先度を緊急に変更する」

セキュリティに関する考慮事項

サーバーは環境変数を通じてTodoist APIトークンを安全に処理します
.envファイルを共有したり、APIトークンを公開したりしないでください。
サーバーはローカルで実行され、Todoist APIとのみ通信します。

ライセンス

MITライセンス

Todoist Python MCP Server

Integrations