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:

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

Board & List Operations

# 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

# 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

# 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

# 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

# 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

# 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

# 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):

1. Get all cards in the list as JSON:

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

2. Analyze the card names and categorize them (e.g., Produce, Dairy, Meat, Bakery, Frozen, etc.)

3. Propose the new order to the user, grouped by category

4. After approval, update positions for each card:

   # 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:

1. Parse user's request for: list, card title, optional description
2. Find the appropriate board/list if not specified
3. Show proposed card details to user
4. 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