trello

Trello

用于通过 Trello REST API（https://api.trello.com/1）操作 Trello 的脚本：创建和移动卡片、管理看板和列表、标签和检查清单、评论和附件、成员查找以及搜索。涵盖看板、列表、卡片、标签、检查清单、成员和搜索的 44 个脚本。

Trello 的独立非官方连接器。与 Trello 无关联，未获其认可或赞助。“Trello” 是其所有者的商标，在此仅用于标识此连接器所支持的服务。

适用场景

• Agent 需要创建或更新卡片——添加任务、设置截止日期、分配成员、添加标签，或归档／重新打开卡片。
• Agent 需要整理看板——创建看板和列表、在列表之间移动卡片、复制看板，或关闭（归档）看板。
• Agent 需要按名称查找 Trello 资源——在写入之前查找看板、列表、标签或检查清单。
• Agent 需要搜索卡片，或读取看板／列表／卡片详情以用于规划或报告。

设置

这是一个 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 个字符的十六进制字符串。当用户提到看板、列表或标签时，先调用匹配的 find* 或 list* 脚本，并将返回的 ID 传入创建／更新／移动脚本 — 切勿猜测 ID。

消歧与拒绝

写入前先消歧。 在向按名称查找的看板、列表、卡片、标签或检查清单写入前（例如，在通过 findList 找到的列表上创建卡片，或添加通过 findLabel 找到的标签），统计名称完全匹配且不区分大小写的结果：

• 恰好一个匹配项 — 对其执行操作。不要过度追问；只有一个明确匹配项时，它就是答案。
• 两个或更多匹配项并列 — 停止操作。列出并列候选项及其可区分字段（ID + 名称 + 看板／列表上下文），并询问用户指的是哪一个。不要随意挑选，也不要对所有匹配项执行写入。

不支持的操作 — 明确说明并停止；不要用其他脚本假装可以完成。 本目录有意不提供以下功能：

• 管理 Webhook、自动化或 Power-Up。 没有触发器或 Butler 规则脚本。
• 上传本地二进制文件。 addCardAttachment 仅接受 URL 或远程文件 URL — 不接受本地路径或 Base64 负载。
• 永久删除看板或卡片。 closeBoard 和 archiveCard 会归档（软关闭）资源；没有彻底删除脚本。
• 管理工作区账单、管理员设置或企业策略。

如果用户要求执行上述任何操作，告知用户不支持该操作并停止 — 不要调用无关脚本来近似实现。

身份验证

每种形态传递的都是一个连接选择器，而非密钥 — 格式为 [<resolver>:]<value> 字符串。每个连接器都接受 zapier:<connection-id>（由 Zapier 管理的身份验证 — 通过 Zapier 的身份验证、重试和治理层）；部分连接器还接受一个或多个直接令牌解析器（名称和数量因连接器而异）— 请检查此连接器自身的解析器，不要想当然。<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（列表、看板、标签）的写入操作之前