Todoist MCP サーバー (Python)

Todoist Python APIを使ってPythonで書かれたTodoist MCPサーバーです。最初はClaudeを使ってTypeScriptで書かれたTodoist MCPサーバーをPythonに翻訳し、サーバーを作成しました。Claudeを使ってタスク管理を試しながら、自分のワークフローに合わせて徐々に変更や機能追加を行っています。

インストール

前提条件

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

Todoist APIトークンを取得する

Todoistアカウントにログイン
設定→統合へ移動
「開発者」の下でAPIトークンを見つけます

Claude Desktopによる構成

claude_desktop_config.jsonにMCPサーバーを追加します。

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

または、ローカルコピーから実行するには、

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": [
        "--from",
        "/absolute/path/to/todoist-mcp-server",
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

Related MCP server: Todoist MCP Server

利用可能なツール

現在利用可能なツールを確認するには、

# With GNU grep installed as ggrep (as with `brew install grep` on Mac)
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' src/main.py

2025年5月26日現在、

プロジェクト
- 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_get_task
- todoist_get_tasks
- todoist_filter_tasks
- todoist_add_task
- todoist_update_task
- todoist_complete_task
- todoist_uncomplete_task
- todoist_move_task
- todoist_delete_task
コメント
- todoist_get_comment
- todoist_get_comments
- todoist_add_comment
- todoist_update_comment
- todoist_delete_comment