Trello Toolkit
The Trello toolkit lets agents work with Trello boards, lists, and cards: browse boards, read lists and cards, create and update cards, and search across the workspace. Authentication uses a Trello API key and token (not OAuth).
Add it on the agent Toolkits tab, connect credentials, then reference tools with @ in the personality prompt.
Prerequisites
- A Trello account with access to the boards the agent should use
- A Trello API key and token (see Setup)
- An agent you can edit
Setup
- In Trello, open Power-Ups admin, create a Power-Up if needed, then Generate a new API key.
- Next to the key, choose manually generate a Token, authorize access, and copy the token.
- Open the agent → Toolkits → add Trello.
- Create or select a connection and enter the API key and token.
- Save,
@-mention Trello tools in the personality prompt, and test by listing boards.
Available tools
| Tool | Description |
|---|---|
| List Boards | Lists boards the credentials can access (closed boards are excluded). |
| Get Board Lists | Lists columns/lists on a board. |
| Get Cards in List | Lists cards in a list. |
| Get Card | Returns details for one card. |
| Create Card | Creates a card in a list (name, optional Markdown description, position, due date, labels, members). |
| Update Card | Updates a card (name, description, move to another list, due date, archive/unarchive). |
| Search | Searches cards and/or boards (default focuses on cards; result limit capped). |
Use cases
- Create a card from a chat request and put it on the right list
- Move or update a card when status changes
- Find cards by keyword across boards
- Summarize what is on a board or in a specific list
Tips
- Credentials can access only what that Trello token was authorized for.
- Prefer board, list, and card IDs when names are ambiguous.
- Card descriptions support Markdown.
- Keep the API key and token out of prompts, tickets, and screenshots.
Troubleshooting
| Symptom | What to check |
|---|---|
| Auth / 401 errors | Regenerate the token if revoked; confirm key and token belong together |
| Empty board list | Token lacks access; authorize the correct Trello account |
| Cannot create or update cards | Permissions on the board; confirm list ID |
| Search returns nothing | Broaden the query; confirm boards vs cards filter |