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.

通过Composio的Rube MCP集成，自动化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
```
获取当前工具的架构

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位十六进制或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)

任务	工具标识	关键参数
列出用户的看板	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（逗号分隔的路径）