Trello MCP Server(delorenj 版)
- 最終確認:
- 2026-05-26
- ライセンス:
- MIT
Trello とは
Trello は、Atlassian 傘下のカンバン式タスク管理 SaaS です。ボード上にリストを並べ、リスト内のカードを動かすシンプルなビジュアルで、個人タスク管理から小規模チームのプロジェクト進行まで世界中で使われています。Free プランから利用でき、日本でも個人・中小企業に広く採用されています。
API キー取得の注意: Trello API キー取得フローは Atlassian 公式が 「事前に Power-Up の作成が必要」 と案内しており(Atlassian Developer Docs 逐語)、README が案内する
https://trello.com/app-keyの単純取得フローと齟齬がある可能性があります。最新の手順は Atlassian 公式ドキュメントを併せてご確認ください。
Trello × AI でできること
この MCP サーバーを導入すると、Trello のプロジェクト管理を AI への一言で操作できます。
🎯 自分のタスクの俯瞰
「今日期限の自分のカードを優先度順に」
→ get_my_cards でカード横断取得
✏️ カードの追加・更新
「『今週のタスク』リストに新規カードを追加」
→ add_card_to_list でカード作成
🔄 カードの一括移動
「『進行中』のカードを『レビュー待ち』へまとめて移動」
→ move_card / update_card_details
📊 活動履歴の要約
「先週のボード活動を一覧化」
→ get_recent_activity で取得 + AI 要約
提供される主なツール
delorenj/mcp-server-trello が提供する主要ツール(全 55 ツールのうち主なもの 31 件を抜粋・v1.7.1 時点):
カード操作(7)
| ツール名 | 機能 |
|---|---|
get_card | ID 指定でカード取得 |
get_cards_by_list_id | リスト ID 配下のカード一覧 |
add_card_to_list | リストにカードを新規追加 |
update_card_details | カード詳細を更新 |
archive_card | カードをアーカイブ |
move_card | カードを移動 |
get_my_cards | 自分が担当のカード一覧 |
チェックリスト(7)
| ツール名 | 機能 |
|---|---|
get_checklist_items | チェックリスト項目取得 |
add_checklist_item | チェックリスト項目追加 |
find_checklist_items_by_description | 説明文でチェック項目検索 |
get_acceptance_criteria | 受け入れ基準取得 |
get_checklist_by_name | 名前でチェックリスト取得 |
update_checklist_item | チェックリスト項目更新 |
delete_checklist_item | チェックリスト項目削除 |
コメント(4)
| ツール名 | 機能 |
|---|---|
add_comment | コメント追加 |
update_comment | コメント更新 |
delete_comment | コメント削除 |
get_card_comments | カードのコメント取得 |
ファイル添付(2)
| ツール名 | 機能 |
|---|---|
attach_image_to_card | カードに画像添付 |
attach_file_to_card | カードにファイル添付 |
ボード・リスト・ワークスペース管理(11)
| ツール名 | 機能 |
|---|---|
get_lists | リスト一覧取得 |
get_recent_activity | 最近の活動取得 |
add_list_to_board | ボードにリスト追加 |
archive_list | リストをアーカイブ |
update_list_position | リスト位置を更新 |
list_boards | ボード一覧 |
set_active_board | アクティブボード設定 |
list_workspaces | ワークスペース一覧 |
set_active_workspace | アクティブワークスペース設定 |
list_boards_in_workspace | ワークスペース配下ボード一覧 |
get_active_board_info | 現在のアクティブボード情報 |
Trello MCP Server について
本 MCP は、コミュニティ開発者 delorenj が公開する Trello 用 MCP サーバーです(リポジトリ: delorenj/mcp-server-trello)。Bun ランタイムで動作し、bunx @delorenj/mcp-server-trello で起動する設計です(package.json description: "An MCP server for Trello boards, powered by Bun for maximum performance.")。
スペック
- 配布形態: npm パッケージ(
@delorenj/mcp-server-trello)+ Smithery - 実行ランタイム: Bun v1.0.0 以上(README 記載・
bunxで起動) - 認証: Trello API キー(
TRELLO_API_KEY)+ Trello トークン(TRELLO_TOKEN) - マルチボード対応: v0.3.0 以降で複数のボード操作方式に対応(README 記載)
- レート制限: 300 リクエスト / 10 秒 / API キー、100 リクエスト / 10 秒 / トークン(README 記載)
- 日付形式: Due Date は ISO 8601(時刻付き)、Start Date は YYYY-MM-DD(日付のみ)(README 記載)
- プロキシ:
https_proxy環境変数対応 - 提供元: コミュニティ(delorenj)/ MIT ライセンス
- 最新バージョン: v1.7.1(npm 確認・2026-05-26 時点)
- 最終コミット: 2026-05-23(非常に活発)
- Star 数: 362(GitHub・2026-05-26 時点)
- 公式リポジトリ: github.com/delorenj/mcp-server-trello
導入手順
1. Bun のインストール
Bun は Node.js 互換の JavaScript ランタイムです。公式インストール手順 に従って導入してください(具体的なインストールコマンドは OS により異なるため公式ページの記載に従ってください)。
2. Trello API キーとトークンの取得
- trello.com/app-key にアクセスし、API キーを取得
- 同ページから Manual Token Generation のリンクで Token を発行(API キーをページに貼って実行)
重要: Atlassian 公式 docs では「事前に Power-Up を作成が必要」と案内されており(公式)、README の
trello.com/app-key直接取得と齟齬があります。trello.com/app-keyでうまく取れなかった場合は Power-Up 経由 (trello.com/power-ups/admin) もお試しください。
3. クライアント設定(Claude Desktop の例)
claude_desktop_config.json に以下を追記し、TRELLO_API_KEY と TRELLO_TOKEN を実値に置き換えます。
{
"mcpServers": {
"trello": {
"command": "bunx",
"args": ["@delorenj/mcp-server-trello"],
"env": {
"TRELLO_API_KEY": "<YOUR_TRELLO_API_KEY>",
"TRELLO_TOKEN": "<YOUR_TRELLO_TOKEN>"
}
}
}
}
4. 動作確認
クライアントを再起動 → 「自分が担当の Trello カードを 5 件取得」と依頼。get_my_cards が呼ばれてカード一覧が返ってくれば成功です。
注意事項
- Bun ランタイムが必要です。Node.js(
npx)では起動できません。Bun のインストールに不慣れな場合は事前に公式ドキュメント を確認してください。 - API キーとトークンは Trello アカウントへの強力な権限を持ちます。ソースコード・チャット履歴・公開リポジトリにそのまま貼らないでください。漏洩時は Trello 管理画面から失効・再発行できます。
- Trello プラン要件は README に記載がありません。一般に Trello Free プランでも API は利用できますが、Workspace の数や Power-Up の使用は有料プランで上限緩和される場合があります。詳細は Atlassian 公式ドキュメントをご確認ください。
- API レート制限は API キーあたり 300 req / 10 秒、トークンあたり 100 req / 10 秒(README 記載)。大量のカードを一括操作する際は分割してください。
- 書き込み系・削除系ツール(
archive_card/delete_comment/delete_checklist_item/update_card_details等)は AI が誤って実行する可能性があります。重要なボードでは AI のスコープを制限するか、まず別ボードで動作確認することを推奨します。 - コミュニティ製 MCP のため、Atlassian 社の公式サポート対象外です。動作不具合は GitHub Issue で開発者 delorenj にご相談ください。
設定方法
MCP は、お使いの対応アプリ(クライアント)に下記の設定を貼り付けて使います。 タブからアプリを選び、表示された設定をコピーしてください。
Claude Desktop: Anthropic 公式のデスクトップ版 Claude アプリ
{
"mcpServers": {
"trello": {
"command": "bunx",
"args": ["@delorenj/mcp-server-trello"],
"env": {
"TRELLO_API_KEY": "<YOUR_TRELLO_API_KEY>",
"TRELLO_TOKEN": "<YOUR_TRELLO_TOKEN>"
}
}
}
}
Cursor: AI 機能を内蔵したコードエディタ
{
"mcpServers": {
"trello": {
"command": "bunx",
"args": ["@delorenj/mcp-server-trello"],
"env": {
"TRELLO_API_KEY": "<YOUR_TRELLO_API_KEY>",
"TRELLO_TOKEN": "<YOUR_TRELLO_TOKEN>"
}
}
}
}
Cline: VS Code に追加する AI アシスタント拡張
{
"mcpServers": {
"trello": {
"command": "bunx",
"args": ["@delorenj/mcp-server-trello"],
"env": {
"TRELLO_API_KEY": "<YOUR_TRELLO_API_KEY>",
"TRELLO_TOKEN": "<YOUR_TRELLO_TOKEN>"
}
}
}
}
主なユースケース
- 「今日期限の自分のカードを優先度順に出して」と頼むと `get_my_cards` で横断取得してくれる
- 新規タスクを追加する依頼に対し `add_card_to_list` で対象リストにカードを作成できる
- 「『進行中』のカードを『レビュー待ち』へまとめて移動」のような一括操作を `move_card` / `update_card_details` で実行できる
- AI に「先週の活動履歴を一覧化」を頼むと `get_recent_activity` でアクティビティを取得・要約できる
プラットフォーム別の注意事項
- プロキシ環境:プロキシ環境では `https_proxy` 環境変数の設定が必要な場合があります(README 記載)。