Todoist MCP サーバー

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

特徴

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

Related MCP server: Notion MCP

前提条件

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