trello

Trello

Trello REST API（https://api.trello.com/1）を使用して Trello を操作するスクリプトです。カードの作成と移動、ボードとリストの管理、ラベルとチェックリスト、コメントと添付ファイル、メンバーの検索、検索に対応しています。ボード、リスト、カード、ラベル、チェックリスト、メンバー、検索に関する 44 個のスクリプトを収録しています。

Trello 向けの独立した非公式コネクターです。Trello との提携、推奨、スポンサー関係はありません。「Trello」はその所有者の商標であり、このコネクターが連携するサービスを示す目的でのみ使用しています。

こんなときに使います

• エージェントがカードを作成または更新する必要がある場合 — タスクの追加、期限の設定、メンバーの割り当て、ラベルの追加、カードのアーカイブまたは再開を行います。
• エージェントがボードを整理する必要がある場合 — ボードやリストの作成、リスト間のカードの移動、ボードのコピー、またはボードの終了（アーカイブ）を行います。
• エージェントが名前から Trello リソースを検索する必要がある場合 — 書き込みを行う前に、ボード、リスト、ラベル、チェックリストを探します。
• エージェントがカードを検索したり、計画やレポート作成のためにボード、リスト、カードの詳細を読み取ったりする必要がある場合。

セットアップ

これは agentskills.io のスキルです。

コネクターがまだスキルとしてインストールされていない場合は、npx skills add zapier/connectors --skill trello（またはお使いのハーネス独自のスキルインストール方法）でインストールしてから、ここに進んでください。スキルをインストールすると、依存関係ではなく、これらのファイルがコピーされます。CLI、ローカル MCP サーバー、または zapier-sdk の認証コマンドを実行する前に、ここで一度 npm install --omit=dev を実行してください。公開パッケージを依存関係として自分のプロジェクトにインポートする場合は、すでに npm install ですべての依存関係が解決されています。詳しくは references/use-as-sdk.md を参照してください。

代わりにリポジトリの実際のソースを確認したい場合 — references/ の閲覧、このコネクターのテストの実行、または変更を行いたい場合 — スコープを指定した git clone については README.md を参照してください。

このコネクターの実行には Node.js 22.18+ が必要です。実行方法に合ったリファレンスを選び、ほかの作業を始める前に読み込んでください。

使用環境...	読み込むもの
MCP 対応クライアント — ツールがすでに読み込まれている場合があります（例：mcp__trello__<tool>）。または自分でローカルサーバーを登録できます（あるいはユーザーに案内できます）	references/use-as-mcp.md
ターミナル／サブプロセスへのアクセス（node を実行できる）	references/use-as-cli.md
自分のコードのみを使用し、このパッケージを依存関係としてインポートする	references/use-as-sdk.md
ツールやターミナルへのアクセスがなく、このパッケージをインポートすることもできない — Trello API を直接呼び出す独自コードを作成する（例：コード実行サンドボックス）	references/use-as-recipe.md

スクリプト

すべてのスクリプトで、単一の接続 trello を使用します。共通ヘルパーは lib/trello.ts にあります。

スクリプト	スクリプト名	接続	説明
scripts/createBoard.ts	createBoard	単一（trello）	ワークスペースに新しいボードを作成します
scripts/copyBoard.ts	copyBoard	単一（trello）	カードを保持するかどうかを指定してボードをコピーします
scripts/closeBoard.ts	closeBoard	単一（trello）	ボードをアーカイブ（閉鎖）します
scripts/getBoard.ts	getBoard	単一（trello）	IDでボードを取得します
scripts/listBoards.ts	listBoards	単一（trello）	認証済みメンバーがアクセスできるボードの一覧を取得します
scripts/findBoard.ts	findBoard	単一（trello）	名前でボードを検索します
scripts/listBoardMembers.ts	listBoardMembers	単一（trello）	ボードのメンバー一覧を取得します
scripts/addMemberToBoard.ts	addMemberToBoard	単一（trello）	IDまたはメールアドレスでメンバーをボードに追加します
scripts/createList.ts	createList	単一（trello）	ボードにリストを作成します
scripts/getList.ts	getList	単一（trello）	IDでリストを取得します
scripts/listLists.ts	listLists	単一（trello）	ボード上のすべてのリストを取得します
scripts/findList.ts	findList	単一（trello）	名前でボード上のリストを検索します
scripts/createCard.ts	createCard	単一（trello）	メンバー、ラベル、添付ファイルを任意で指定して、リストにカードを作成します
scripts/updateCard.ts	updateCard	単一（trello）	カードのフィールド（名前、説明、期限、カバー、リスト）を更新します
scripts/archiveCard.ts	archiveCard	単一（trello）	カードをアーカイブ（閉鎖）します
scripts/moveCard.ts	moveCard	単一（trello）	カードを別のリストまたはボードに移動します
scripts/getCard.ts	getCard	単一（trello）	IDでカードを取得します
scripts/listCards.ts	listCards	単一（trello）	任意のフィルターを指定して、ボード上のカード一覧を取得します
scripts/searchCards.ts	searchCards	単一（trello）	TrelloクエリDSLまたは構造化フィルターを使ってカードを検索します
scripts/createComment.ts	createComment	単一（trello）	カードにコメントを追加します
scripts/getAction.ts	getAction	単一（trello）	IDでアクション（アクティビティ）を取得します
scripts/listCardAttachments.ts	listCardAttachments	単一（trello）	カードの添付ファイル一覧を取得します
scripts/addCardAttachment.ts	addCardAttachment	単一（trello）	URL添付ファイルを追加するか、リモートファイルをカードにリンクします
scripts/createLabel.ts	createLabel	単一（trello）	ボードにラベルを作成します
scripts/getLabel.ts	getLabel	単一（trello）	IDでラベルを取得します
scripts/listLabels.ts	listLabels	単一（trello）	ボードのラベル一覧を取得します
scripts/findLabel.ts	findLabel	単一（trello）	名前でボード上のラベルを検索します
scripts/addCardLabel.ts	addCardLabel	単一（trello）	既存のラベルをカードに追加します
scripts/removeCardLabel.ts	removeCardLabel	単一（trello）	カードからラベルを削除します
scripts/createChecklist.ts	createChecklist	単一（trello）	カードにチェックリストを作成します
scripts/getChecklist.ts	getChecklist	単一（trello）	IDでチェックリストを取得します
scripts/deleteChecklist.ts	deleteChecklist	単一（trello）	チェックリストを削除します
scripts/findChecklist.ts	findChecklist	単一（trello）	名前でカード上のチェックリストを検索します
scripts/addChecklistItem.ts	addChecklistItem	単一（trello）	チェックリストに項目を追加します
scripts/getChecklistItem.ts	getChecklistItem	単一（trello）	IDでチェックリスト項目を取得します
scripts/findChecklistItem.ts	findChecklistItem	単一（trello）	名前でチェックリスト項目を検索します
scripts/completeChecklistItem.ts	completeChecklistItem	単一（trello）	チェックリスト項目を完了または未完了としてマークします
scripts/getCurrentMember.ts	getCurrentMember	単一（trello）	認証済みメンバーを取得します
scripts/getMember.ts	getMember	単一（trello）	IDでメンバーを取得します
scripts/findOrganizationMember.ts	findOrganizationMember	単一（trello）	ワークスペース内のメンバーを検索します
scripts/getOrganization.ts	getOrganization	単一（trello）	IDでワークスペースを取得します
scripts/listOrganizations.ts	listOrganizations	単一（trello）	メンバーが所属するワークスペースの一覧を取得します
scripts/addCardMember.ts	addCardMember	単一（trello）	カードにメンバーを追加します
scripts/listCustomFields.ts	listCustomFields	単一（trello）	ボードのカスタムフィールド定義一覧を取得します
書き込みの前に ID を解決してください。 Trello の ID は 24 文字の 16 進数文字列です。ユーザーがボード、リスト、またはラベルを指定した場合は、まず対応する find* または list* スクリプトを呼び出し、返された ID を create/update/move スクリプトに渡してください。ID を推測してはいけません。

曖昧さの解消と拒否

書き込みの前に曖昧さを解消してください。 名前で検索したボード、リスト、カード、ラベル、またはチェックリストに書き込む前（例：findList で見つけたリストにカードを作成する、または findLabel で見つけたラベルを追加する場合）、大文字と小文字を区別しない完全一致の名前の件数を確認してください。

• 一致がちょうど 1 件 — その項目に対して操作してください。過剰に確認を求めてはいけません。曖昧さのない一致が 1 件なら、それが答えです。
• 同数の候補が 2 件以上 — そこで停止してください。識別できるフィールド（ID ＋名前＋ボード／リストのコンテキスト）とともに同数の候補を提示し、どれを指しているのかユーザーに確認してください。独断で選んだり、すべてに書き込んだりしてはいけません。

未対応の操作 — 未対応であることを伝えて停止してください。別のスクリプトで代用してはいけません。 このカタログでは、意図的に以下の操作に対応していません。

• Webhook、オートメーション、Power-Up の管理。 トリガーや Butler ルールのスクリプトはありません。
• ローカルのバイナリファイルのアップロード。 addCardAttachment が受け付けるのは URL またはリモートファイルの URL のみです。ローカルパスや base64 ペイロードには対応していません。
• ボードやカードの完全削除。 closeBoard と archiveCard はリソースをアーカイブ（一時的に閉じる）します。完全削除用のスクリプトはありません。
• ワークスペースの請求、管理者設定、エンタープライズポリシーの管理。

これらを依頼された場合は、未対応であることをユーザーに伝えて停止してください。近似させるために無関係なスクリプトを使ってはいけません。

認証

すべてのシェイプでは、認証情報そのものではなく、1 つの接続セレクターを [<resolver>:]<value> 形式の文字列で渡します。すべてのコネクターで zapier:<connection-id> を使用できます（Zapier 管理の認証。Zapier の認証、再試行、ガバナンス層を経由します）。一部のコネクターでは、1 つ以上の直接トークン用リゾルバーも使用できます（名称と数はコネクターによって異なります）。想定で判断せず、このコネクター固有のリゾルバーを確認してください。<resolver>: のプレフィックスは省略可能です。プレフィックスのない値は、それを受け付ける最初のリゾルバーに渡されます。UUID 形式のプレフィックスなしの値は、必ず zapier: によって受け付けられます。各スクリプトでは、必要な接続と、受け付けるリゾルバーを宣言しています。接続を渡す正確な構文（およびこのコネクターのリゾルバー一覧の確認方法）はシェイプによって異なります。上記で読み込んだリファレンスを参照してください。

すでに設定済みのものを確認しますか？そのために環境変数の値を出力してはいけません。env や env | grep <name> は名前とともに値も表示するため、設定されていると有効な認証情報がトランスクリプトに漏えいします。名前だけを確認するか（env | cut -d= -f1 | grep -i <name>）、既知の名前を直接テストしてください（[ -n "$VAR_NAME" ]）。

まだ接続していませんか？どちらかを選び、認証情報を取得するにはリファレンスに記載された手順に従ってください。すでに覚えているはずの接続 ID やトークンをユーザーに尋ねてはいけません。

	読み込み
認証情報を直接渡す	references/use-without-zapier.md
Zapier 接続を経由させる	references/use-with-zapier.md

出力形式

すべてのスクリプトは { data, meta } エンベロープを返します。

• data — スクリプトの結果（outputSchema が宣言する形式です。スクリプトの正確なスキーマを確認する方法については、上で読み込んだリファレンスを参照してください）。
• meta.outputDataValidation — data の検証結果です。
  • { skipped: false, droppedPaths: null } — 検証され、何も削除されませんでした。
  • { skipped: false, droppedPaths: [...], instruction } — 検証されましたが、該当するパスが data から削除されました。これらはスクリプトが API から返したフィールドのうち、outputSchema で宣言されていないものです。必要な場合は、出力検証をスキップして再実行してください。
  • { skipped: true } — 検証はスキップされ、data は未検証のスクリプト出力そのままです。

削除されたフィールドの確認／skipOutputDataValidation。 未検証の生の結果を受け取るには、出力検証を無効にします（正確な構文はシェイプによって異なります。上で読み込んだリファレンスを参照してください）。入力検証はスキップされません。

結果の絞り込み／filterOutputData。 大きな結果を必要なフィールドだけに絞り込むには、data を後処理する jq 式を渡します（正確な構文はシェイプごとに異なります）。jq が処理するのは data のみで、{ data, meta } エンベロープは対象ではありません。そのため、data を起点に記述してください（出力スキーマを確認するには、スクリプトの --help またはシェイプに相当する機能を実行してください）。変換後の値が data に設定され、meta は保持されます。また、結果は出力スキーマに対して再検証されません。

リファレンス

該当する領域で作業する前に、対応するリファレンスファイルを読み込んでください。

リファレンス	内容	読み込むタイミング
references/trello-api-gotchas.md	Trello API の動作、ID 解決のパターン、レート制限、検索 DSL の特有の仕様	検索を多用するフロー、レート制限の影響を受けるループ、または ID 解決が必要な書き込み（リスト、ボード、ラベル）の前