What credentials are required?

An API key and token, set as environment variables TRELLO_API_KEY and TRELLO_TOKEN.

Which Trello actions can I automate with this skill?

Listing boards, lists, and cards; creating cards; moving cards; adding comments; and archiving cards.

How do I handle rate limits?

Be mindful of Trello's limits (e.g., 300 requests/10s per key, 100 requests/10s per token) and implement retry/backoff as needed.

Trello

Verified

@steipete

npx machina-cli add skill @steipete/trello --openclaw

Files (1)

SKILL.md

2.6 KB

Trello Skill

Manage Trello boards, lists, and cards directly from Clawdbot.

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"

Usage

All commands use curl to hit the Trello REST API.

List boards

curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'

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 to another list

curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
  -d "idList={newListId}"

Add a comment to a card

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"

Notes

Board/List/Card IDs can be found in the Trello URL or via the list commands
The API key and token provide full access to your Trello account - keep them secret!
Rate limits: 300 requests per 10 seconds per API key; 100 requests per 10 seconds per token; /1/members endpoints are limited to 100 requests per 900 seconds

Examples

# Get all boards
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN&fields=name,id" | jq

# Find a specific 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"))'

# 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}'

Source

git clone https://clawhub.ai/steipete/trelloView on GitHub

Overview

Trello skill lets you manage boards, lists, and cards directly from Clawdbot using the Trello REST API. It supports listing boards, lists and cards, creating cards, moving cards between lists, adding comments, and archiving cards. Use it to automate Trello workflows from the command line.

How This Skill Works

Authenticate with your Trello API key and token provided as environment variables (TRELLO_API_KEY and TRELLO_TOKEN). The skill builds REST API requests (GET, POST, PUT) and uses curl to execute them, piping results through jq when available for structured output.

When to Use It

Inventory Trello boards by listing all boards with their names and IDs.
Create new cards in a specific list when a workflow fires.
Move cards between lists to reflect status changes.
Add comments to cards to log updates or notes.
Archive completed or obsolete cards to keep boards clean.

Quick Start

Step 1: export TRELLO_API_KEY="your-api-key"; export TRELLO_TOKEN="your-token"
Step 2: curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
Step 3: 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"

Best Practices

Store credentials in environment variables and never commit them to code.
Limit payloads and parse with jq for clean outputs.
Test actions on a staging board before applying to production boards.
Validate IDs from Trello responses or URLs before performing actions.
Respect Trello rate limits to avoid throttling and errors.

Example Use Cases

List all boards for your account and display each board's name and id.
Show all lists in a board and capture their id and name.
Create a new card named 'Card Title' in a given list with a description.
Move a card to a different list by updating its idList.
Add a comment to a card and then archive it when the task is complete.

Frequently Asked Questions

Add this skill to your agents