---
title: Trello
description: Manage Trello lists, cards, and activity
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="trello"
  color="#0052CC"
/>

{/* MANUAL-CONTENT-START:intro */}
[Trello](https://trello.com) is a visual collaboration tool that helps you organize projects, tasks, and workflows using boards, lists, and cards.

With Trello in Sim, you can:

- **List boards and lists**: View the boards you have access to and their associated lists.
- **List and search cards**: Retrieve all cards on a board or filter by list to see their content and status.
- **Create cards**: Add new cards to a Trello list, including descriptions, labels, and due dates.
- **Update and move cards**: Edit card properties, move cards across lists, and set due dates or labels.
- **Get recent activity**: Retrieve actions and activity history for boards and cards.
- **Comment on cards**: Add comments to cards for collaboration and tracking.

Integrating Trello with Sim empowers your agents to manage your team’s tasks, boards, and projects programmatically. Automate project management workflows, keep task lists up-to-date, synchronize with other tools, or trigger intelligent workflows in response to Trello events—all through your AI agents.
{/* MANUAL-CONTENT-END */}


## Usage Instructions

{/* MANUAL-CONTENT-START:usage */}
### Trello OAuth Setup

Before connecting Trello in Sim, add your Sim app origin to the **Allowed Origins** list for your Trello API key in the Trello Power-Up admin settings.

Trello's authorization flow redirects back to Sim using a `return_url`. If your Sim origin is not whitelisted in Trello, Trello will block the redirect and the connection flow will fail before Sim can save the token.
{/* MANUAL-CONTENT-END */}


Integrate with Trello to list board lists, list cards, create cards, update cards, review activity, and add comments.



## Tools

### `trello_list_lists`

List all lists on a Trello board

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `boardId` | string | Yes | Trello board ID \(24-character hex string\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `lists` | array | Lists on the selected board |
|   ↳ `id` | string | List ID |
|   ↳ `name` | string | List name |
|   ↳ `closed` | boolean | Whether the list is archived |
|   ↳ `pos` | number | List position on the board |
|   ↳ `idBoard` | string | Board ID containing the list |
| `count` | number | Number of lists returned |

### `trello_list_cards`

List cards from a Trello board or list

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `boardId` | string | No | Trello board ID to list open cards from. Provide either boardId or listId |
| `listId` | string | No | Trello list ID to list cards from. Provide either boardId or listId |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `cards` | array | Cards returned from the selected Trello board or list |
|   ↳ `id` | string | Card ID |
|   ↳ `name` | string | Card name |
|   ↳ `desc` | string | Card description |
|   ↳ `url` | string | Full card URL |
|   ↳ `idBoard` | string | Board ID containing the card |
|   ↳ `idList` | string | List ID containing the card |
|   ↳ `closed` | boolean | Whether the card is archived |
|   ↳ `labelIds` | array | Label IDs applied to the card |
|   ↳ `labels` | array | Labels applied to the card |
|     ↳ `id` | string | Label ID |
|     ↳ `name` | string | Label name |
|     ↳ `color` | string | Label color |
|   ↳ `due` | string | Card due date in ISO 8601 format |
|   ↳ `dueComplete` | boolean | Whether the due date is complete |
| `count` | number | Number of cards returned |

### `trello_create_card`

Create a new card in a Trello list

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `listId` | string | Yes | Trello list ID \(24-character hex string\) |
| `name` | string | Yes | Name/title of the card |
| `desc` | string | No | Description of the card |
| `pos` | string | No | Position of the card \(top, bottom, or positive float\) |
| `due` | string | No | Due date \(ISO 8601 format\) |
| `dueComplete` | boolean | No | Whether the due date should be marked complete |
| `labelIds` | array | No | Label IDs to attach to the card |
| `items` | string | No | A Trello label ID |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `card` | json | Created card \(id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete\) |
|   ↳ `id` | string | Card ID |
|   ↳ `name` | string | Card name |
|   ↳ `desc` | string | Card description |
|   ↳ `url` | string | Full card URL |
|   ↳ `idBoard` | string | Board ID containing the card |
|   ↳ `idList` | string | List ID containing the card |
|   ↳ `closed` | boolean | Whether the card is archived |
|   ↳ `labelIds` | array | Label IDs applied to the card |
|   ↳ `labels` | array | Labels applied to the card |
|     ↳ `id` | string | Label ID |
|     ↳ `name` | string | Label name |
|     ↳ `color` | string | Label color |
|   ↳ `due` | string | Card due date in ISO 8601 format |
|   ↳ `dueComplete` | boolean | Whether the due date is complete |

### `trello_update_card`

Update an existing card on Trello

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `cardId` | string | Yes | Trello card ID \(24-character hex string\) |
| `name` | string | No | New name/title of the card |
| `desc` | string | No | New description of the card |
| `closed` | boolean | No | Archive/close the card \(true\) or reopen it \(false\) |
| `idList` | string | No | Trello list ID to move card to \(24-character hex string\) |
| `due` | string | No | Due date \(ISO 8601 format\) |
| `dueComplete` | boolean | No | Mark the due date as complete |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `card` | json | Updated card \(id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete\) |
|   ↳ `id` | string | Card ID |
|   ↳ `name` | string | Card name |
|   ↳ `desc` | string | Card description |
|   ↳ `url` | string | Full card URL |
|   ↳ `idBoard` | string | Board ID containing the card |
|   ↳ `idList` | string | List ID containing the card |
|   ↳ `closed` | boolean | Whether the card is archived |
|   ↳ `labelIds` | array | Label IDs applied to the card |
|   ↳ `labels` | array | Labels applied to the card |
|     ↳ `id` | string | Label ID |
|     ↳ `name` | string | Label name |
|     ↳ `color` | string | Label color |
|   ↳ `due` | string | Card due date in ISO 8601 format |
|   ↳ `dueComplete` | boolean | Whether the due date is complete |

### `trello_get_actions`

Get activity/actions from a board or card

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `boardId` | string | No | Trello board ID \(24-character hex string\). Either boardId or cardId required |
| `cardId` | string | No | Trello card ID \(24-character hex string\). Either boardId or cardId required |
| `filter` | string | No | Filter actions by type \(e.g., "commentCard,updateCard,createCard" or "all"\) |
| `limit` | number | No | Maximum number of board actions to return |
| `page` | number | No | Page number for action results |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `actions` | array | Action items \(id, type, date, idMemberCreator, text, memberCreator, card, board, list\) |
|   ↳ `id` | string | Action ID |
|   ↳ `type` | string | Action type |
|   ↳ `date` | string | Action timestamp |
|   ↳ `idMemberCreator` | string | ID of the member who created the action |
|   ↳ `text` | string | Comment text when present |
|   ↳ `memberCreator` | object | Member who created the action |
|     ↳ `id` | string | Member ID |
|     ↳ `fullName` | string | Member full name |
|     ↳ `username` | string | Member username |
|   ↳ `card` | object | Card referenced by the action |
|     ↳ `id` | string | Card ID |
|     ↳ `name` | string | Card name |
|     ↳ `shortLink` | string | Short card link |
|     ↳ `idShort` | number | Board-local card number |
|     ↳ `due` | string | Card due date |
|   ↳ `board` | object | Board referenced by the action |
|     ↳ `id` | string | Board ID |
|     ↳ `name` | string | Board name |
|     ↳ `shortLink` | string | Short board link |
|   ↳ `list` | object | List referenced by the action |
|     ↳ `id` | string | List ID |
|     ↳ `name` | string | List name |
| `count` | number | Number of actions returned |

### `trello_add_comment`

Add a comment to a Trello card

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `cardId` | string | Yes | Trello card ID \(24-character hex string\) |
| `text` | string | Yes | Comment text |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `comment` | json | Created comment action \(id, type, date, idMemberCreator, text, memberCreator, card, board, list\) |
|   ↳ `id` | string | Action ID |
|   ↳ `type` | string | Action type |
|   ↳ `date` | string | Action timestamp |
|   ↳ `idMemberCreator` | string | ID of the member who created the comment |
|   ↳ `text` | string | Comment text |
|   ↳ `memberCreator` | object | Member who created the comment |
|     ↳ `id` | string | Member ID |
|     ↳ `fullName` | string | Member full name |
|     ↳ `username` | string | Member username |
|   ↳ `card` | object | Card referenced by the comment |
|     ↳ `id` | string | Card ID |
|     ↳ `name` | string | Card name |
|     ↳ `shortLink` | string | Short card link |
|     ↳ `idShort` | number | Board-local card number |
|     ↳ `due` | string | Card due date |
|   ↳ `board` | object | Board referenced by the comment |
|     ↳ `id` | string | Board ID |
|     ↳ `name` | string | Board name |
|     ↳ `shortLink` | string | Short board link |
|   ↳ `list` | object | List referenced by the comment |
|     ↳ `id` | string | List ID |
|     ↳ `name` | string | List name |


