tomevault-io Trello CLI
Manage Trello boards, lists, and cards using the trello-cli command.
Important Rules
- Only activate when "Trello" is mentioned - Do not interfere with Notion, Jira, or other tools
- Check JSON output after each command -
ok: truemeans success,ok: falsemeans error - 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 --create-card <list-id> "<name>" --labels "<id1>,<id2>" --members "<id1>,<id2>"
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
Labels
trello-cli --get-labels <board-id> # List labels on board
trello-cli --create-label <board-id> "<name>" --color <color> # Create label
trello-cli --update-label <label-id> --name "<name>" --color <color>
trello-cli --delete-label <label-id> # Delete label
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
Source: ZenoxZX/trello-cli — distributed by TomeVault.