Trello MCP Server

Trello MCP Server とは？

Trello MCP Server は、コミュニティが開発した trello mcp 連携です。Model Context Protocol を通じて、AI エージェントが Trello のボード、リスト、カード、チェックリスト、コメント、添付ファイル、カスタムフィールドを読み取り、更新できるようにします。

delorenj がメンテナンスしており、npm では @delorenj/mcp-server-trello として公開されています。ライセンスは MIT で、公式 MCP Registry には io.github.delorenj/mcp-server-trello として掲載されています。Trello や Atlassian が開発・サポートしているものではありません。README によると 57 個のツール、組み込みのレート制限、Bun ベースのビルドを備え、stdio でローカル実行されます。

Trello MCP Server の使い方

前提条件：

• Trello アカウントと、trello.com/app-key で取得する API key。
• 同じページで API key を使って生成する Trello token。
• Bun（bunx 用）または Node.js（npx 用）。README によると bunx が最も速く起動し、npx でも同じように動作します。

環境変数：

# Required
TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token

# Optional (deprecated): default board ID, can be changed later with set_active_board
TRELLO_BOARD_ID=your-board-id

# Optional: initial workspace ID, can be changed later with set_active_workspace
TRELLO_WORKSPACE_ID=your-workspace-id

# Optional: HTTPS proxy
https_proxy=http://your-proxy:8080

# Optional: restrict access to specific workspaces (comma-separated IDs)
TRELLO_ALLOWED_WORKSPACES=workspace-id-1,workspace-id-2

Claude Code

CLI で trello mcp server を登録します。

claude mcp add trello \
  --env TRELLO_API_KEY=your-trello-api-key \
  --env TRELLO_TOKEN=your-trello-token \
  -- bunx @delorenj/mcp-server-trello

Claude Desktop

Claude Desktop の MCP 設定に次の内容を追加し、アプリを再起動します。

{
  "mcpServers": {
    "trello": {
      "command": "bunx",
      "args": ["@delorenj/mcp-server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-trello-api-key",
        "TRELLO_TOKEN": "your-trello-token"
      }
    }
  }
}

Cursor

README のクイックスタート設定は、Cursor やその他の MCP クライアントにもそのまま使えます。上記の mcpServers ブロックを Cursor の MCP 設定に追加してください。Bun の代わりに npm を使う場合は、bunx を npx に置き換えます。

接続後の最初の操作としては、list_boards を呼び出し、set_active_board でボードを選び、get_active_board_info で確認するのが一般的です。

Trello MCP Server の主な機能

• ボード全体をカバー：カード、リスト、チェックリスト、ラベル、メンバー、コメント、添付ファイル、カスタムフィールド、ボードのアクティビティに対応します。
• 受け入れ基準の抽出：get_acceptance_criteria は Acceptance Criteria、AC、DoD、Definition of Done という名前のチェックリストを探し、項目、未完了の項目、完了率を返します。
• ボードとワークスペースの動的切り替え：再起動せずにアクティブなボードやワークスペースを変更できます。選択内容は ~/.trello-mcp/config.json に保存されます。
• ワークスペースの許可リスト：TRELLO_ALLOWED_WORKSPACES で、エージェントが一覧表示・利用・ボード作成できるワークスペースを制限します。
• 組み込みのレート制限：トークンバケット方式で Trello の制限（API key ごとに 10 秒あたり 300 リクエスト、token ごとに 10 秒あたり 100 リクエスト）を守り、上限に達するとリクエストをキューに入れます。
• ファイル添付：URL またはローカルの file:// パスからファイルを添付でき、添付ファイルのダウンロードも可能です。
• Markdown 出力：get_card に includeMarkdown を指定すると、カードを読みやすい Markdown で返します。
• プロキシ対応：https_proxy または HTTPS_PROXY を通じて Trello API の通信を中継します。

Trello MCP Server のツール

• ボードとワークスペース：list_boards、set_active_board、get_active_board_info、list_workspaces、set_active_workspace、list_boards_in_workspace がナビゲーションを担います。他のほとんどのツールは任意の boardId を受け付けるので、1 つのセッションで複数のボードを扱えます。
• リスト：get_lists、add_list_to_board、update_list、update_list_position（先頭、末尾、または小数の位置）、archive_list。
• カード：get_card はカードの詳細をすべて返します。get_cards_by_list_id、get_my_cards、add_card_to_list、update_card_details、move_card、archive_card でカードのライフサイクル全体を扱えます。期限日は時刻付きの ISO 8601 形式、開始日は YYYY-MM-DD 形式です。
• チェックリスト：get_checklist_items、get_checklist_by_name、add_checklist_item、update_checklist_item、delete_checklist_item、find_checklist_items_by_description、get_acceptance_criteria。
• コメント：add_comment、update_comment、delete_comment、get_card_comments。
• 添付ファイル：attach_image_to_card、attach_file_to_card、download_attachment。
• カスタムフィールド：get_board_custom_fields と update_card_custom_field。カスタムフィールドには Trello Standard 以上のプランが必要です。
• アクティビティ：get_recent_activity に加え、アクティビティを Trello の通知に届ける watch_card と watch_list。

Trello MCP Server のユースケース

• 毎日のタスク整理：「自分に割り当てられたカードをすべて表示して、期限切れのものを教えて」。エージェントは get_my_cards を使います。
• スプリントの準備：「この仕様書の各項目について Backlog リストにカードを作り、期限を来週の金曜日にして」。
• 完了の定義のチェック：「カード FdhbArbK で、まだ満たされていない受け入れ基準はどれ？」。エージェントは get_acceptance_criteria を使います。
• 進捗の報告：「Marketing ボードの最近のアクティビティを要約して、ローンチのカードにコメントを投稿して」。
• 作業を前に進める：「Review リストにあるカードのうち、チェックリストがすべて完了しているものを Done に移動して」。
• ビジュアル素材：README で紹介されている Ideogram サーバーなど、別の MCP サーバーと組み合わせ、生成した画像を attach_image_to_card でカードに添付します。

Trello MCP Server と代替ツールの比較

Python 実装を含め、コミュニティ製の Trello MCP サーバーは他にもいくつかありますが、公式 MCP Registry に掲載されているのは delorenj/mcp-server-trello です。チームが別のツールで作業を管理している場合は、Jira と Confluence 向けの Atlassian MCP Server、Asana MCP Server、ClickUp MCP Server、Linear MCP Server と比較してみてください。このサーバーはローカル専用で、個人の Trello key と token で認証します。ホスト型の OAuth サービスではありません。

Trello MCP Server のトラブルシューティング

• 認証エラー：TRELLO_API_KEY と TRELLO_TOKEN の両方が設定されているか、また token が trello.com/app-key で同じ API key から生成されたものかを確認してください。
• ボードが違う、または「invalid ID」エラーが出る：list_boards と set_active_board を呼び出すか、boardId を明示的に渡してください。TRELLO_BOARD_ID は非推奨です。また、アクティブなボードは ~/.trello-mcp/config.json に保存されるため、以前の選択が残っている可能性があります。
• ワークスペースやボードが表示されない：TRELLO_ALLOWED_WORKSPACES が設定されている場合、そこに含まれるワークスペースしか一覧表示・利用できません。ID を追加するか、変数を削除してください。
• リクエストが止まる、または遅くなる：Trello のレート制限に達すると、サーバーはリクエストをキューに入れます。そのため大量の処理は失敗せず、少しの間待機します。
• カスタムフィールドの更新に失敗する：カスタムフィールドには Trello Standard 以上が必要です。list 型のフィールドには、get_board_custom_fields が返すオプション ID を使ってください。