Trello Board Management

Manage Trello boards, lists, and cards via the Trello REST API.

Prerequisites

•Credentials configured in ~/.trello/ (run setup if not done)
•jq, curl installed

Setup

If not configured, run:

bash

~/.claude/skills/trello/scripts/trello-setup.sh

Board & List Operations

bash

# List all boards
~/.claude/skills/trello/scripts/trello-boards.sh boards

# Find board by name
~/.claude/skills/trello/scripts/trello-boards.sh find "Shopping"

# Get board details
~/.claude/skills/trello/scripts/trello-boards.sh board <board-id>

# List all lists in a board
~/.claude/skills/trello/scripts/trello-boards.sh lists <board-id>

# Get list details
~/.claude/skills/trello/scripts/trello-boards.sh list <list-id>

Card Operations

Listing Cards

bash

# List cards in a list
~/.claude/skills/trello/scripts/trello-cards.sh list <list-id>

# List more cards
~/.claude/skills/trello/scripts/trello-cards.sh list <list-id> 100

# Get JSON output (for scripting/sorting)
~/.claude/skills/trello/scripts/trello-cards.sh list-json <list-id>

# Read full card details
~/.claude/skills/trello/scripts/trello-cards.sh read <card-id>

Creating & Updating Cards

bash

# Create a card
~/.claude/skills/trello/scripts/trello-cards.sh create <list-id> "Card title" "Optional description"

# Update card field (name, desc, due, closed)
~/.claude/skills/trello/scripts/trello-cards.sh update <card-id> name "New title"

# Move card to another list
~/.claude/skills/trello/scripts/trello-cards.sh move <card-id> <list-id>

Positioning Cards

bash

# Move card to top of list
~/.claude/skills/trello/scripts/trello-cards.sh top <card-id>

# Move card to bottom of list
~/.claude/skills/trello/scripts/trello-cards.sh bottom <card-id>

# Set specific position (number or 'top'/'bottom')
~/.claude/skills/trello/scripts/trello-cards.sh position <card-id> 12345

Comments

bash

# Add comment
~/.claude/skills/trello/scripts/trello-cards.sh comment <card-id> "Comment text"

# List comments
~/.claude/skills/trello/scripts/trello-cards.sh comments <card-id>

Archive & Delete

bash

# Archive card
~/.claude/skills/trello/scripts/trello-cards.sh archive <card-id>

# Restore archived card
~/.claude/skills/trello/scripts/trello-cards.sh unarchive <card-id>

# Delete permanently
~/.claude/skills/trello/scripts/trello-cards.sh delete <card-id>

Card Details

bash

# Show labels
~/.claude/skills/trello/scripts/trello-cards.sh labels <card-id>

# Show assigned members
~/.claude/skills/trello/scripts/trello-cards.sh members <card-id>

# Show checklists
~/.claude/skills/trello/scripts/trello-cards.sh checklist <card-id>

Workflow: Smart Sorting (e.g., Shopping List by Category)

When user wants to sort cards by category (like food items by store section):

•

Get all cards in the list as JSON:

bash

~/.claude/skills/trello/scripts/trello-cards.sh list-json <list-id>

•
Analyze the card names and categorize them (e.g., Produce, Dairy, Meat, Bakery, Frozen, etc.)
•
Propose the new order to the user, grouped by category

•

After approval, update positions for each card:

bash

# First card gets position 1000
~/.claude/skills/trello/scripts/trello-cards.sh position <card-id-1> 1000
# Second card gets position 2000
~/.claude/skills/trello/scripts/trello-cards.sh position <card-id-2> 2000
# And so on...

This keeps the original list but reorders cards so same-category items are grouped together.

Workflow: Adding Items

Always confirm before creating:

•Parse user's request for: list, card title, optional description
•Find the appropriate board/list if not specified
•Show proposed card details to user
•Create card only after explicit approval

Error Handling

•Invalid credentials: Re-run setup
•Board/list not found: Check ID or use find command
•Rate limited: Wait a few seconds and retry (300 req/10s per key)

Notes

•Board/List/Card IDs can be found in Trello URLs or via 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