クロード MCP Trello

Trelloボードを操作するためのツールを提供するModel Context Protocol（MCP）サーバー。このサーバーは、レート制限、型安全性、エラー処理を自動的に処理しながら、Trello APIとのシームレスな統合を実現します。

特徴

Trelloボードとの完全な統合：カード、リスト、ボードアクティビティを操作
組み込みのレート制限: Trello の API 制限 (API キーあたり 300 リクエスト/10 秒、トークンあたり 100 リクエスト/10 秒) を尊重
型安全な実装:包括的な型定義を備えたTypeScriptで記述
入力検証: すべてのAPI入力に対する堅牢な検証
エラー処理: 情報メッセージによる適切なエラー処理

利用可能なツール

`trello_get_cards_by_list`

指定されたリスト ID に含まれるカードのリストを取得します。

{
  name: "trello_get_cards_by_list",
  arguments: {
    listId: string; // Trello list ID
  }
}

`trello_get_lists`

ボード内のすべてのリストを取得します。

{
  name: "trello_get_lists",
  arguments: {}
}

`trello_get_recent_activity`

最新のボードアクティビティを取得します。limit limitで取得する件数を指定できます（デフォルト：10）。

{
  name: "trello_get_recent_activity",
  arguments: {
    limit?: number; // Optional: number of activities to retrieve
  }
}

`trello_add_card`

指定されたリストにカードを追加します。

{
  name: "trello_add_card",
  arguments: {
    listId: string;       // The ID of the list to add to
    name: string;         // The title of the card
    description?: string; // Optional: details of the card
    dueDate?: string;     // Optional: due date (e.g., ISO8601)
    labels?: string[];    // Optional: array of label IDs
  }
}

`trello_update_card`

カードの内容を更新します。

{
  name: "trello_update_card",
  arguments: {
    cardId: string;       // The ID of the card to be updated
    name?: string;        // Optional: updated title
    description?: string; // Optional: updated description
    dueDate?: string;     // Optional: updated due date (e.g., ISO8601)
    labels?: string[];    // Optional: updated array of label IDs
  }
}

`trello_archive_card`

指定されたカードをアーカイブ（閉じる）します。

{
  name: "trello_archive_card",
  arguments: {
    cardId: string; // The ID of the card to archive
  }
}

`trello_add_list`

ボードに新しいリストを追加します。

{
  name: "trello_add_list",
  arguments: {
    name: string; // Name of the new list
  }
}

`trello_archive_list`

指定されたリストをアーカイブ（閉じる）します。

{
  name: "trello_archive_list",
  arguments: {
    listId: string; // The ID of the list to archive
  }
}

`trello_get_my_cards`

アカウントに関連するすべてのカードを取得します。

{
  name: "trello_get_my_cards",
  arguments: {}
}

`trello_search_all_boards`

プラン/権限に応じて、ワークスペース (組織) 内のすべてのボード間でクロスボード検索を実行します。

{
  name: "trello_search_all_boards",
  arguments: {
    query: string;   // Search keyword
    limit?: number;  // Optional: max number of results (default: 10)
  }
}

レート制限

サーバーは、Trello の API 制限に準拠するために、レート制限用のトークンバケットアルゴリズムを実装します。

APIキーごとに10秒あたり300リクエスト
トークンごとに10秒あたり100リクエスト

レート制限は自動的に処理され、制限に達した場合、リクエストはキューに入れられます。

エラー処理

サーバーは、さまざまなシナリオに対して詳細なエラーメッセージを提供します。

無効な入力パラメータ
レート制限を超えました
API認証エラー
ネットワークの問題
無効なボード/リスト/カードID

発達

前提条件

Node.js 16以上
npmまたはyarn

設定

リポジトリをクローンします。
git clone https://github.com/hrs-asano/claude-mcp-trello.git cd claude-mcp-trello
依存関係をインストールします:

npm install

プロジェクトをビルドします。

npm run build

テストの実行

npm test

Claude Desktopとの統合

この MCP サーバーを Claude Desktop と統合するには、~/Library/Application\ Support/Claude/claude_desktop_config.json ファイルに次の構成を追加します。

{
  "mcpServers": {
    "trello": {
      "command": "{YOUR_NODE_PATH}", // for example: /opt/homebrew/bin/node
      "args": [
        "{YOUR_PATH}/claude-mcp-trello/build/index.js"
      ],
      "env": {
        "TRELLO_API_KEY": "{YOUR_KEY}",
        "TRELLO_TOKEN": "{YOUR_TOKEN}",
        "TRELLO_BOARD_ID": "{YOUR_BOARD_ID}"
      }
    }
  }
}

{YOUR_NODE_PATH}、{YOUR_PATH}、{YOUR_KEY}、{YOUR_TOKEN}、および {YOUR_BOARD_ID} を、ご使用の環境に適した値に置き換えてください。

貢献

貢献を歓迎します！行動規範とプルリクエストの送信手順の詳細については、貢献ガイドをお読みください。

ライセンス

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

謝辞

モデルコンテキストプロトコルSDKで構築
Trello REST APIを使用します

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Trello ボードと対話するためのツールを提供し、レート制限と型安全性を処理しながらカード、リスト、アクティビティをシームレスに管理できるようにするモデルコンテキストプロトコルサーバー。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Trello MCP Server
andypost
A
security
F
license
A
quality
Enables interaction with Trello boards, lists, and cards through Model Context Protocol (MCP) tools, leveraging TypeScript for type safety and asynchronous operations.
Last updated -
5
1
JavaScript
Trello MCP Server with Python
m0xai
-
security
F
license
-
quality
A powerful MCP server for interacting with Trello boards, lists, and cards via AI Hosts.
Last updated -
30
Python
MCP Trino Server
alaturqua
-
security
A
license
-
quality
A Model Context Protocol server that provides seamless integration with Trino and Iceberg, enabling data exploration, querying, and table maintenance through a standard interface.
Last updated -
19
Python
Apache 2.0
Trello MCP Server
ag2-mcp-servers
-
security
F
license
-
quality
This is an MCP Server for Trello that enables interaction with Trello's API through natural language, allowing management of boards, cards, lists, and other Trello resources.
Last updated -
Python

View all related MCP servers

Claude MCP Trello