trello-mcp-server

🚀 Trello MCP Server：AI を活用したプロジェクト管理

Trello のボードを、AI エージェントのための活きたワークスペースに変えましょう。この Model Context Protocol (MCP) サーバーを使うと、LLM（Gemini、Claude、GPT-4 など）が自然言語でプロジェクトを確認、整理、管理できます。

---

🔍 概要

このプロジェクトは、AI と Trello のワークフローをつなぎます。カードを手動で移動する代わりに、AI に「「To Do」リストにある「Urgent」ラベル付きのカードをすべて「In Progress」に移動して、自分に割り当てて」と伝えることができます。

どこからでも利用可能： このプロジェクトは、コンピューター上のどこにでも保存できます。一度登録すれば、必要なときに AI がサーバーを自動的に起動できるため、ターミナルで手動実行する必要はありません。

---

📋 前提条件

• Node.js（v20.0.0 以上を推奨） - こちらからダウンロード
• Git - こちらからダウンロード
• Trello API Key and Token：こちらから取得

---

🛠️ クイックスタート

1. インストールとビルド

# Clone the repository
git clone https://github.com/BillNobill/trello-mcp-server.git

# Install dependencies and build
npm install
npm run build

2. 設定

プロジェクトのルートに .env ファイルを作成します（テンプレートとして .env.example を使用してください）。

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token
TRELLO_BASE_URL=https://api.trello.com/1

3. AI クライアントへの登録

Claude Code（推奨）

claude mcp add --scope user trello node "C:\FULL_PATH\TO\trello-mcp-server\dist\index.js"

環境変数は .env ファイルから読み込まれるか、-e KEY=VALUE フラグを使ってインラインで渡すことができます。

VS Code（GitHub Copilot / Claude 拡張機能）

ユーザーの settings.json に追加します（Ctrl+Shift+P → ユーザー設定を開く（JSON））。

{
  "mcp": {
    "servers": {
      "trello": {
        "command": "node",
        "args": ["C:\\FULL_PATH\\TO\\trello-mcp-server\\dist\\index.js"],
        "env": {
          "TRELLO_API_KEY": "your_api_key",
          "TRELLO_TOKEN": "your_token",
          "TRELLO_BASE_URL": "https://api.trello.com/1"
        }
      }
    }
  }
}

Cursor

%USERPROFILE%\.cursor\mcp.json に追加します。

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["C:\\FULL_PATH\\TO\\trello-mcp-server\\dist\\index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_TOKEN": "your_token",
        "TRELLO_BASE_URL": "https://api.trello.com/1"
      }
    }
  }
}

重要

上記の設定では、必ず dist/index.js の絶対パスを使用してください。

---

⚡ 利用可能なツール

AI エージェントは、以下の高度な機能を自動的に「習得」します。

📋 ボードとリストの管理

• list_boards：すべての Trello ボードを一覧表示します。
• read_board：リスト、カード、ラベル、メンバーを詳しく確認します。
• get_lists_on_board：列の名前と ID のみを取得します。
• create_list / update_list：ボードの列とその順序（pos）を管理します。
• archive_list：ボードの構成を整理します。
• get_board_labels / get_board_members：正確な自動化に必要な ID を取得します。
• create_label / update_label：ボードのラベル（名前と色）を管理します。

🗂️ カード操作（詳細かつ最適化済み）

• get_cards_in_list：特定の列にあるカードを取得します。
• get_card_details：1 枚のカードについて、コメント、添付ファイル、チェックリストを詳しく確認します。
• search_cards：ボード全体を対象に、テキストベースの高速検索を実行します。
• create_card / update_card：タスクの作成または変更（名前、説明、日付、ラベル、pos）を行います。
• move_card：リスト間でタスクのステータスを変更します（pos に対応）。
• move_all_cards：あるリストから別のリストへすべてのカードを移動する一括操作です。
• archive_card：完了した作業を整理します。

✅ チェックリストの管理（詳細かつ柔軟）

• add_checklist：カードに新しいチェックリストの見出しを作成します。
• update_checklist：既存のチェックリストの見出しの名前や順序を変更します。
• delete_checklist：チェックリストを完全に削除します。
• create_checkitem：既存のチェックリストに新しい項目を追加します。
• update_checkitem：項目を更新します（名前の変更、完了／未完了の切り替え、順序の変更）。
• delete_checkitem：チェックリストから特定の項目を削除します。

📁 ファイルと添付ファイル

• add_attachment：URL ベースのリンクをカードに添付します。
• upload_file：PDF、スクリプト、レポートなどの実ファイルを、コンピューターからカードに直接アップロードします。

🛠️ プロフェッショナル向け機能

• set_custom_field：カスタムフィールド（例：「Estimate」、「Project ID」）の値を設定します。注：ボードで Custom Fields Power-Up を有効にする必要があります。
• assign_member：チームメイトをタスクに割り当てます。
• add_comment：AI を通じてタスクについて直接話し合います。

ヒント

並べ替え（pos パラメーター）：
カード、リスト、チェックリスト、項目を正確に並べ替えるには、'top'、'bottom'、または正の数（例：1）を使用します。

---

🛠️ トラブルシューティング

警告

サーバーが「切断済み」と表示されますか？

1. コマンドが空です： クライアントの MCP 設定を確認し、"command": "node" と dist/index.js への絶対パスが正しいことを確認してください。
2. 環境変数： ターミナルで node dist/index.js を手動で実行してください。失敗する場合は、ルートフォルダーに .env がない可能性があります。
3. SDK の互換性： このプロジェクトでは @modelcontextprotocol/sdk v1.29.0 を使用しています。プロトコルエラーが発生する場合は、正しいバージョンがインストールされていることを確認するため、npm install を実行してください。
4. Claude Code： Claude Code のセッション内で /mcp を実行すると、サーバーのステータスとエラー出力を確認できます。

---

🐳 Docker のサポート

ヒント

Docker はローカル環境をすっきり保つのに最適です。

# Build
docker build -t trello-mcp-server .

# Run
docker run --rm -i --env-file .env trello-mcp-server

---

🤝 コントリビューション

コントリビューションを歓迎します！バグを見つけた場合や機能のリクエストがある場合は、issue を作成するか、プルリクエストを送信してください。

---

[Luiz Feltrin] が作成
ぜひ応援してください！このリポジトリが役に立ったら、⭐️を付けてください！