Todoist MCP Server

🚀 Todoist MCP サーバー（Python）

Python で書かれた Todoist MCP サーバーで、Todoist Python API を使用しています。最初は、Claude を使って TypeScript Todoist MCP サーバー を Python に翻訳することでこのサーバーを作成しました。Claude を使ったタスク管理の実験を重ねるにつれ、自分のワークフローに合わせて機能を追加したり修正したりしてきました。

🚀 クイックスタート

このサーバーは、Python と UV パッケージマネージャーを使用して構築されています。以下の手順に従ってサーバーをセットアップしてください。

📦 インストール

前提条件

• Python 3.10 以上
• UV パッケージマネージャー（インストールガイド）
• Todoist API トークン

Todoist API トークンの取得

1. Todoist アカウントにログインします。
2. 設定 → 統合に移動します。
3. 「開発者」セクションの下にある API トークンを見つけます。

Claude Desktop の設定

以下の内容を claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "todoist": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/todoist-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

💻 使用例

利用可能なツールの確認

以下のコマンドを実行して、現在利用可能なツールを確認します。

# GNU grep をインストールしていることを前提としています（例: Mac では `brew install grep`）
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' main.py

2025 年 4 月 25 日現在、利用可能なツールは以下の通りです。

• プロジェクト
  • todoist_get_projects
  • todoist_get_project
  • todoist_add_project
  • todoist_update_project
  • todoist_delete_project
• セクション
  • todoist_get_sections
  • todoist_get_section
  • todoist_add_section
  • todoist_update_section
  • todoist_delete_section
• タスク
  • todoist_create_task
  • todoist_get_tasks
  • todoist_get_task
  • todoist_update_task
  • todoist_move_task
  • todoist_close_task
  • todoist_reopen_task
  • todoist_delete_task

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。