trello-automation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Trello Automation via Rube MCP

通过Rube MCP实现Trello自动化

Automate Trello board management, card creation, and team workflows through Composio's Rube MCP integration.

Toolkit docs: composio.dev/toolkits/trello

通过Composio的Rube MCP集成，实现Trello看板管理、卡片创建与团队工作流的自动化。

工具包文档：composio.dev/toolkits/trello

Prerequisites

前置条件

Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
Active Trello connection via
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
trello
```
Always call
```
RUBE_SEARCH_TOOLS
```
first to get current tool schemas

必须已连接Rube MCP（需有可用的RUBE_SEARCH_TOOLS）
通过
```
RUBE_MANAGE_CONNECTIONS
```
并使用工具包
```
trello
```
激活Trello连接
始终先调用
```
RUBE_SEARCH_TOOLS
```
获取当前工具的 schema

Setup

设置步骤

Get Rube MCP: Add

https://rube.app/mcp

as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

Verify Rube MCP is available by confirming
```
RUBE_SEARCH_TOOLS
```
responds
Call
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
trello
```
If connection is not ACTIVE, follow the returned auth link to complete Trello auth
Confirm connection status shows ACTIVE before running any workflows

获取Rube MCP：在客户端配置中添加

https://rube.app/mcp

作为MCP服务器。无需API密钥 — 只需添加端点即可使用。

确认
```
RUBE_SEARCH_TOOLS
```
能响应，以此验证Rube MCP是否可用
调用
```
RUBE_MANAGE_CONNECTIONS
```
并指定工具包
```
trello
```
如果连接未处于ACTIVE状态，请按照返回的授权链接完成Trello授权
在运行任何工作流之前，确认连接状态显示为ACTIVE

Core Workflows

核心工作流

1. Create a Card on a Board

1. 在看板中创建卡片

When to use: User wants to add a new card/task to a Trello board

Tool sequence:

```
TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER
```
- List boards to find target board ID [Prerequisite]
```
TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD
```
- Get lists on board to find target list ID [Prerequisite]
```
TRELLO_ADD_CARDS
```
- Create the card on the resolved list [Required]
```
TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD
```
- Add a checklist to the card [Optional]

TRELLO_ADD_CARDS_CHECKLIST_CHECK_ITEM_BY_ID_CARD_BY_ID_CHECKLIST

- Add items to the checklist [Optional]

Key parameters:

```
idList
```
: 24-char hex ID (NOT list name)
```
name
```
: Card title
```
desc
```
: Card description (supports Markdown)
```
pos
```
: Position ('top'/'bottom')
```
due
```
: Due date (ISO 8601 format)

Pitfalls:

Store returned id (idCard) immediately; downstream checklist operations fail without it
Checklist payload may be nested (data.data); extract idChecklist from inner object
One API call per checklist item; large checklists can trigger rate limits

适用场景：用户需要向Trello看板添加新卡片/任务

工具序列:

```
TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER
```
- 列出看板以找到目标看板ID [前置步骤]
```
TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD
```
- 获取看板中的列表以找到目标列表ID [前置步骤]
```
TRELLO_ADD_CARDS
```
- 在已确定的列表中创建卡片 [必需步骤]
```
TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD
```
- 为卡片添加检查清单 [可选步骤]

TRELLO_ADD_CARDS_CHECKLIST_CHECK_ITEM_BY_ID_CARD_BY_ID_CHECKLIST

- 为检查清单添加项目 [可选步骤]

关键参数:

```
idList
```
: 24位十六进制ID（不可使用列表名称）
```
name
```
: 卡片标题
```
desc
```
: 卡片描述（支持Markdown）
```
pos
```
: 位置（'top'/'bottom'）
```
due
```
: 截止日期（ISO 8601格式）

注意事项:

请立即保存返回的id（idCard）；后续的检查清单操作必须依赖该ID
检查清单的返回数据可能嵌套在(data.data)中；需从内部对象提取idChecklist
每个检查清单项目需要单独调用一次API；大量检查清单项目可能触发速率限制

2. Manage Boards and Lists

2. 管理看板与列表

When to use: User wants to view, browse, or restructure board layout

Tool sequence:

```
TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER
```
- List all boards for the user [Required]
```
TRELLO_GET_BOARDS_BY_ID_BOARD
```
- Get detailed board info [Required]
```
TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD
```
- Get lists (columns) on the board [Optional]
```
TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD
```
- Get board members [Optional]
```
TRELLO_GET_BOARDS_LABELS_BY_ID_BOARD
```
- Get labels on the board [Optional]

Key parameters:

```
idMember
```
: Use 'me' for authenticated user
```
filter
```
: 'open', 'starred', or 'all'
```
idBoard
```
: 24-char hex or 8-char shortLink (NOT board name)

Pitfalls:

Some runs return boards under response.data.details[]—don't assume flat top-level array
Lists may be nested under results[0].response.data.details—parse defensively
ISO 8601 timestamps with trailing 'Z' must be parsed as timezone-aware

适用场景：用户需要查看、浏览或重构看板布局

工具序列:

```
TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER
```
- 列出用户的所有看板 [必需步骤]
```
TRELLO_GET_BOARDS_BY_ID_BOARD
```
- 获取看板详细信息 [必需步骤]
```
TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD
```
- 获取看板中的列表（列） [可选步骤]
```
TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD
```
- 获取看板成员 [可选步骤]
```
TRELLO_GET_BOARDS_LABELS_BY_ID_BOARD
```
- 获取看板中的标签 [可选步骤]

关键参数:

```
idMember
```
: 对于已认证用户，使用'me'
```
filter
```
: 'open'、'starred'或'all'
```
idBoard
```
: 24位十六进制ID或8位shortLink（不可使用看板名称）

注意事项:

部分执行结果会将看板放在response.data.details[]下 — 不要假设返回的是扁平的顶层数组
列表可能嵌套在results[0].response.data.details下 — 需谨慎解析
带有尾部'Z'的ISO 8601时间戳必须解析为带时区的时间

3. Move Cards Between Lists

3. 在列表间移动卡片

When to use: User wants to change a card's status by moving it to another list

Tool sequence:

```
TRELLO_GET_SEARCH
```
- Find the card by name or keyword [Prerequisite]
```
TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD
```
- Get destination list ID [Prerequisite]
```
TRELLO_UPDATE_CARDS_BY_ID_CARD
```
- Update card's idList to move it [Required]

Key parameters:

```
idCard
```
: Card ID from search
```
idList
```
: Destination list ID
```
pos
```
: Optional ordering within new list

Pitfalls:

Search returns partial matches; verify card name before updating
Moving doesn't update position within new list; set pos if ordering matters

适用场景：用户需要通过将卡片移动到另一个列表来更改卡片状态

工具序列:

```
TRELLO_GET_SEARCH
```
- 通过名称或关键词查找卡片 [前置步骤]
```
TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD
```
- 获取目标列表ID [前置步骤]
```
TRELLO_UPDATE_CARDS_BY_ID_CARD
```
- 更新卡片的idList以完成移动 [必需步骤]

关键参数:

```
idCard
```
: 搜索得到的卡片ID
```
idList
```
: 目标列表ID
```
pos
```
: 可选参数，用于设置在新列表中的排序位置

注意事项:

搜索会返回部分匹配结果；在更新前请确认卡片名称
移动操作不会更新卡片在新列表中的位置；如需指定排序请设置pos参数

4. Assign Members to Cards

4. 为卡片分配成员

When to use: User wants to assign team members to cards

Tool sequence:

```
TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD
```
- Get member IDs from the board [Prerequisite]
```
TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD
```
- Add a member to the card [Required]

Key parameters:

```
idCard
```
: Target card ID
```
value
```
: Member ID to assign

Pitfalls:

UPDATE_CARDS_ID_MEMBERS replaces entire member list; use ADD_CARDS_ID_MEMBERS to append
Member must have board permissions

适用场景：用户需要为卡片分配团队成员

工具序列:

```
TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD
```
- 从看板中获取成员ID [前置步骤]
```
TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD
```
- 为卡片添加成员 [必需步骤]

关键参数:

```
idCard
```
: 目标卡片ID
```
value
```
: 要分配的成员ID

注意事项:

UPDATE_CARDS_ID_MEMBERS会替换整个成员列表；如需追加成员请使用ADD_CARDS_ID_MEMBERS
被分配的成员必须拥有该看板的权限

5. Search and Filter Cards

5. 搜索与筛选卡片

When to use: User wants to find specific cards across boards

Tool sequence:

```
TRELLO_GET_SEARCH
```
- Search by query string [Required]

Key parameters:

```
query
```
: Search string (supports board:, list:, label:, is:open/archived operators)
```
modelTypes
```
: Set to 'cards'
```
partial
```
: Set to 'true' for prefix matching

Pitfalls:

Search indexing has delay; newly created cards may not appear for several minutes
For exact name matching, use TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD and filter locally
Query uses word tokenization; common words may be ignored as stop words

适用场景：用户需要跨看板查找特定卡片

工具序列:

```
TRELLO_GET_SEARCH
```
- 通过查询字符串搜索卡片 [必需步骤]

关键参数:

```
query
```
: 搜索字符串（支持board:、list:、label:、is:open/archived等操作符）
```
modelTypes
```
: 设置为'cards'
```
partial
```
: 设置为'true'以启用前缀匹配

注意事项:

搜索索引存在延迟；新创建的卡片可能需要几分钟才会出现在搜索结果中
如需精确匹配卡片名称，请使用TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD并在本地筛选
查询使用分词处理；常用词可能会被作为停用词忽略

6. Add Comments and Attachments

6. 添加评论与附件

When to use: User wants to add context to an existing card

Tool sequence:

TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD

- Post a comment on the card [Required]

```
TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD
```
- Attach a file or URL [Optional]

Key parameters:

```
text
```
: Comment text (1-16384 chars, supports Markdown and @mentions)
```
url
```
OR
```
file
```
: Attachment source (not both)
```
name
```
: Attachment display name
```
mimeType
```
: File MIME type

Pitfalls:

Comments don't support file attachments; use the attachment tool separately
Attachment deletion is irreversible

适用场景：用户需要为现有卡片添加上下文信息

工具序列:

TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD

- 在卡片上发布评论 [必需步骤]

```
TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD
```
- 附加文件或URL [可选步骤]

关键参数:

```
text
```
: 评论内容（1-16384字符，支持Markdown和@提及）
```
url
```
或
```
file
```
: 附件来源（不可同时使用）
```
name
```
: 附件显示名称
```
mimeType
```
: 文件MIME类型

注意事项:

评论不支持附加文件；请单独使用附件工具
附件删除操作不可撤销

Common Patterns

通用模式

ID Resolution

ID解析

Always resolve display names to IDs before operations:

Board name → Board ID:
```
TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER
```
with idMember='me'
List name → List ID:
```
TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD
```
with resolved board ID
Card name → Card ID:
```
TRELLO_GET_SEARCH
```
with query string
Member name → Member ID:
```
TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD
```

在执行操作前，请务必将显示名称解析为ID：

看板名称 → 看板ID: 使用idMember='me'调用
```
TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER
```
列表名称 → 列表ID: 使用已解析的看板ID调用
```
TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD
```
卡片名称 → 卡片ID: 使用查询字符串调用
```
TRELLO_GET_SEARCH
```
成员名称 → 成员ID: 调用
```
TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD
```

Pagination

分页

Most list endpoints return all items. For boards with 1000+ cards, use

limit

and

before

parameters on card listing endpoints.

大多数列表端点会返回所有项目。对于拥有1000+卡片的看板，请在卡片列表端点使用

limit

和

before

参数。

Rate Limits

速率限制

300 requests per 10 seconds per token. Use

TRELLO_GET_BATCH

for bulk read operations to stay within limits.

每个令牌每10秒最多允许300次请求。对于批量读取操作，请使用

TRELLO_GET_BATCH

以避免超出限制。

Known Pitfalls

常见陷阱

ID Requirements: Nearly every tool requires IDs, not display names. Always resolve names to IDs first.
Board ID Format: Board IDs must be 24-char hex or 8-char shortLink. URL slugs like 'my-board' are NOT valid.
Search Delays: Search indexing has delays; newly created/updated cards may not appear immediately.
Nested Responses: Response data is often nested (data.data or data.details[]); parse defensively.
Rate Limiting: 300 req/10s per token. Batch reads with TRELLO_GET_BATCH.

ID要求: 几乎所有工具都需要ID而非显示名称。请务必先将名称解析为ID。
看板ID格式: 看板ID必须是24位十六进制ID或8位shortLink。类似'my-board'的URL别名是无效的。
搜索延迟: 搜索索引存在延迟；新创建/更新的卡片可能不会立即出现在搜索结果中。
嵌套响应: 响应数据通常是嵌套的（如data.data或data.details[]）；需谨慎解析。
速率限制: 每个令牌每10秒最多300次请求。使用TRELLO_GET_BATCH进行批量读取。

Quick Reference

快速参考

Task	Tool Slug	Key Params
List user's boards	TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER	idMember='me', filter='open'
Get board details	TRELLO_GET_BOARDS_BY_ID_BOARD	idBoard (24-char hex)
List board lists	TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD	idBoard
Create card	TRELLO_ADD_CARDS	idList, name, desc, pos, due
Update card	TRELLO_UPDATE_CARDS_BY_ID_CARD	idCard, idList (to move)
Search cards	TRELLO_GET_SEARCH	query, modelTypes='cards'
Add checklist	TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD	idCard, name
Add comment	TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD	idCard, text
Assign member	TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD	idCard, value (member ID)
Attach file/URL	TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD	idCard, url OR file
Get board members	TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD	idBoard
Batch read	TRELLO_GET_BATCH	urls (comma-separated paths)

Powered by Composio

任务	Tool Slug	关键参数
列出用户的看板	TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER	idMember='me', filter='open'
获取看板详情	TRELLO_GET_BOARDS_BY_ID_BOARD	idBoard（24位十六进制）
列出看板中的列表	TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD	idBoard
创建卡片	TRELLO_ADD_CARDS	idList, name, desc, pos, due
更新卡片	TRELLO_UPDATE_CARDS_BY_ID_CARD	idCard, idList（用于移动）
搜索卡片	TRELLO_GET_SEARCH	query, modelTypes='cards'
添加检查清单	TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD	idCard, name
添加评论	TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD	idCard, text
分配成员	TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD	idCard, value（成员ID）
附加文件/URL	TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD	idCard, url 或 file
获取看板成员	TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD	idBoard
批量读取	TRELLO_GET_BATCH	urls（逗号分隔的路径）

由 Composio 提供支持