home / skills / openclaw / skills / trello

trello skill

safe

/skills/steipete/trello

This skill helps you manage Trello boards, lists, and cards via the Trello REST API from Clawdbot workflows.

npx playbooks add skill openclaw/skills --skill trello

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

2.6 KB

---
name: trello
description: Manage Trello boards, lists, and cards via the Trello REST API.
homepage: https://developer.atlassian.com/cloud/trello/rest/
metadata: {"clawdbot":{"emoji":"📋","requires":{"bins":["jq"],"env":["TRELLO_API_KEY","TRELLO_TOKEN"]}}}
---

# Trello Skill

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

## Setup

1. Get your API key: https://trello.com/app-key
2. Generate a token (click "Token" link on that page)
3. Set environment variables:
   ```bash
   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
```bash
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
```bash
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
```bash
curl -s "https://api.trello.com/1/lists/{listId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id, desc}'
```

### Create a card
```bash
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
```bash
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
```bash
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
```bash
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

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

Overview

This skill lets you manage Trello boards, lists, and cards via the Trello REST API. It provides simple curl examples and patterns to list resources, create and move cards, add comments, and archive items. Setup requires a Trello API key and token stored as environment variables.

How this skill works

The skill issues REST requests to Trello endpoints using your API key and token to authenticate. It demonstrates common operations: fetching boards, listing lists and cards, creating cards, updating card fields to move or archive, and posting comments. Rate limits and sensitive-token handling are highlighted to avoid accidental lockouts and leaks.

When to use it

Automate backups or exports of board structure and card metadata.
Create or update cards programmatically from scripts or CI jobs.
Move or archive cards as part of workflow automation.
Add comments or notes from external systems into Trello cards.
Quickly inspect boards, lists, and cards from a terminal or cron job.

Best practices

Store TRELLO_API_KEY and TRELLO_TOKEN in environment variables and never commit them to source control.
Use the members/me and board endpoints to discover IDs before scripting changes.
Respect Trello rate limits: throttle requests and batch operations when possible.
Prefer PUT/POST calls only after confirming IDs and targets to avoid unintended edits.
Use jq to filter and format responses, making scripting robust and readable.

Example use cases

List all personal boards and extract name/id pairs for inventory or backup scripting.
Get all lists for a specific board to programmatically create matching structures in another system.
Create new cards with descriptions to capture issues or tasks from external notifications.
Move cards between lists to reflect status changes from automation or build systems.
Add a comment to a card from a webhook or monitoring alert to keep activity consolidated.

FAQ

How do I get the API key and token?

Get your API key at https://trello.com/app-key and click the token link on that page to generate a token.

Where do I find board, list, or card IDs?

IDs appear in Trello URLs and can be retrieved with the listed curl commands (members/me/boards, boards/{boardId}/lists, lists/{listId}/cards).

What are the important rate limits?

Expect 300 requests/10s per API key and 100 requests/10s per token; some endpoints like /1/members have stricter limits.