| name | trello |
| description | Manage Trello boards, lists, and cards via the Trello REST API. Use when creating/moving cards, listing boards, or managing project tasks in Trello. Requires TRELLO_API_KEY and TRELLO_TOKEN. |
| alwaysInclude | false |
| requiredBins | ["curl"] |
| platforms | ["darwin","linux"] |
Trello Skill
Manage Trello boards, lists, and cards via the REST API.
Setup
- Get your API key: https://trello.com/app-key
- Generate a token (click "Token" link on that page)
- Set environment variables:
export TRELLO_API_KEY="your-api-key"
export TRELLO_TOKEN="your-token"
Common Operations
List Boards
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN&fields=name,id" | jq
Find a Board by Name
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | select(.name | contains("Work"))'
List Lists in a Board
curl -s "https://api.trello.com/1/boards/{boardId}/lists?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
List Cards in a List
curl -s "https://api.trello.com/1/lists/{listId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id, desc}'
Create a Card
curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "idList={listId}" \
-d "name=Card Title" \
-d "desc=Card description"
Move a Card
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "idList={newListId}"
Add a Comment
curl -s -X POST "https://api.trello.com/1/cards/{cardId}/actions/comments?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "text=Your comment here"
Archive a Card
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "closed=true"
Get All Cards on a Board
curl -s "https://api.trello.com/1/boards/{boardId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, list: .idList}'
Notes
- Board/List/Card IDs can be found in the Trello URL or via the list commands
- Rate limits: 300 requests per 10 seconds per API key; 100 per 10 seconds per token
- Keep API key and token secret
