delorenj/mcp-server-trello

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards.

MCP Server Trello – AI‑friendly Trello bridge

What it is – Model Context Protocol (MCP) を実装する、Bun ベースの軽量なサーバーです。Trello REST API をラップし、AI エージェントがネイティブ関数のように呼び出せる 57 個の型付きツール（例：get_card, add_checklist_item, watch_card）を公開します。サーバーは認証、レート制限、入力バリデーションを処理し、データを JSON またはそのまま貼り付け可能な markdown 形式で返します。

Why it matters – 多くの AI エージェントフレームワーク（Claude Desktop, Cursor など）は、チームのプロジェクトボードを読み書きするための信頼できる方法を必要としています。このサーバーを使用すると、エージェントは カスタム HTTP コードを書くことなく ボードへの full アクセス権を得ることができ、以下のような高度なヘルパー機能が追加されます：

Acceptance‑criteria extraction (get_acceptance_criteria)：適切なチェックリスト（AC, DoD など）を自動的に見つけ、完了率を報告します。
Watch tools (watch_card, watch_list)：Trello のアクティビティをエージェントの通知ストリームにプッシュします。
Dynamic board/workspace switching：同じサーバーで、再起動なしに多くのプロジェクトを管理できます。

Key features

カード、リスト、ボード、チェックリスト、コメント、添付ファイル、ラベル、カスタムフィールドの完全な CRUD 操作。
内蔵のレート制限処理（API キーごとに 10 秒間に 300 回、トークンごとに 10 秒間に 100 回）。
型安全な TypeScript 実装 – エージェントは適切な引数スキーマを受け取ります。
オプションの環境変数サンドボックス化 (TRELLO_ALLOWED_WORKSPACES) によるマルチテナントセキュリティ。
人間が読みやすいコンテキストのための、カードデータの Markdown エクスポート。
bunx または npx で起動できる単一の npm パッケージ (@delorenj/mcp-server-trello) として配布。

How to get it running

Install – npm i -g @delorenj/mcp-server-trello（または MCP クライアントでパッケージを参照するだけで、クローンは不要です）。
Configure – TRELLO_API_KEY と TRELLO_TOKEN を含む .env ファイルを作成します（https://trello.com/app-key から取得可能）。オプションの変数で、デフォルトのボード、ワークスペース、プロキシ、または許可されたワークスペースを制限できます。

Add to an MCP client – 例：Claude Desktop の mcpServers 設定：

{
  "trello": {
    "command": "bunx",
    "args": ["@delorenj/mcp-server-trello"],
    "env": {"TRELLO_API_KEY": "…", "TRELLO_TOKEN": "…"}
  }
}

Start – bunx @delorenj/mcp-server-trello（または npx …）。サーバーは MCP レジストリに自身を登録するため、レジストリ対応のクライアントは自動的に検出できます。
Use the tools – エージェントは、README に示されている JSON ペイロードを使用して、公開されたツールを名前で呼び出します（例：{ "name": "get_card", "arguments": { "cardId": "abc123" } }）。レスポンスには豊富なデータ構造が含まれ、リクエストに応じて markdown レンダリングも行われます。

Skill package – このリポジトリには BMAD 互換の skill ディレクトリも含まれています。skill をインストールすると、サーバーのツールがエージェントのスキルセットに表示され、提供されている install.sh スクリプトは、Bun が存在する場合にサーバーをローカルでビルドします。

Typical workflow

1. list_boards → pick a board ID
2. set_active_board (or set_active_workspace)
3. get_card / get_checklist_items / get_acceptance_criteria
4. update_checklist_item / move_card / add_comment …
5. watch_card to get live updates

Who should use it – Trello ボードを読み書きする必要がある AI アシスタントを構築しているチーム（プロジェクト管理ボット、スプリント計画エージェント、自動化されたレトロスペクティブ）や、生の HTTP 呼び出しの代わりに、型付きでレート制限のある MCP 準拠のインターフェースを求めるすべての人。

Links

npm: https://www.npmjs.com/package/@delorenj/mcp-server-trello
MCP Registry entry: https://registry.modelcontextprotocol.io/servers/io.github.delorenj/mcp-server-trello
Demo badge: https://glama.ai/mcp/servers/klqkamy7wt

delorenj/mcp-server-trello

MCP Server Trello – AI‑friendly Trello bridge

関連