trello-cli

Trello CLI

Manage Trello boards, lists, and cards using the trello-cli command.

Important Rules

1. Only activate when "Trello" is mentioned - Do not interfere with Notion, Jira, or other tools
2. Check JSON output after each command - ok: true means success, ok: false means error
3. Follow the workflow: First find board ID, then list ID, then perform card operations

Quick Reference

Board & List

trello-cli --get-boards                              # List all boards
trello-cli --get-lists <board-id>                    # Get lists in board

Cards

trello-cli --get-all-cards <board-id>                # All cards in board
trello-cli --create-card <list-id> "<name>"          # Create card
trello-cli --create-card <list-id> "<name>" --desc "<desc>" --due "2025-01-15"
trello-cli --update-card <card-id> --name "<name>" --desc "<desc>"
trello-cli --move-card <card-id> <list-id>           # Move card
trello-cli --archive-card <card-id>                  # Archive card
trello-cli --unarchive-card <card-id>                # Unarchive card
trello-cli --delete-card <card-id>                   # Delete card (permanent!)
trello-cli --get-comments <card-id>                  # Get comments
trello-cli --add-comment <card-id> "<text>"          # Add comment

Attachments

trello-cli --list-attachments <card-id>              # List attachments
trello-cli --upload-attachment <card-id> <file-path> [--name "<name>"]
trello-cli --attach-url <card-id> <url> [--name "<name>"]
trello-cli --delete-attachment <card-id> <attach-id>

Note: Downloading attachments is not supported - Trello's download API requires browser authentication. Use --attach-url to link attachments between cards.

Checklists

trello-cli --get-checklists <card-id>                           # Get checklists on card
trello-cli --create-checklist <card-id> "<name>"                # Create checklist
trello-cli --delete-checklist <checklist-id>                    # Delete checklist
trello-cli --add-checklist-item <checklist-id> "<name>"         # Add item
trello-cli --update-checklist-item <card-id> <item-id> <state>  # complete/incomplete
trello-cli --delete-checklist-item <checklist-id> <item-id>     # Delete item

Typical Workflows

List All Tasks

trello-cli --get-boards           # → Get board ID
trello-cli --get-all-cards <id>   # → See all cards

Add New Task

trello-cli --get-boards           # → Get board ID
trello-cli --get-lists <id>       # → Find "To Do" or "Backlog" list ID
trello-cli --create-card <list-id> "<task-name>"

Move to Done

trello-cli --get-lists <board-id> # → Find "Done" list ID
trello-cli --move-card <card-id> <done-list-id>

When Uncertain

If you encounter an error or don't know how to proceed:

trello-cli --help

For detailed command reference, see REFERENCE.md.

Example Scenarios

User: "Show my Trello tasks" → Run --get-boards, then --get-all-cards <board-id>

User: "Add a new task to Trello" → Run --get-boards, --get-lists, then --create-card

User: "Move the card to Done on Trello" → Run --get-lists to find Done ID, then --move-card

User: "Update the Trello card description" → Run --update-card <card-id> --desc "<new-desc>"

User: "Upload this file to the Trello card" → Run --upload-attachment <card-id> "<file-path>"

User: "Link an attachment to another Trello card" → Run --list-attachments <source-card-id> to get the URL, then --attach-url <target-card-id> <url>

User: "Add a checklist to this Trello card" → Run --create-checklist <card-id> "<checklist-name>", then --add-checklist-item for each item

User: "Mark the checklist item as done on Trello" → Run --update-checklist-item <card-id> <item-id> complete