Trello Manager
Interact with Trello via python3 scripts/trello_api.py <command> [args].
Commands
| Command | Args | Description |
|---|---|---|
list_boards | - | Show all boards |
create_board | <name> [desc] | Create board |
list_lists | <board_id> | Show lists in board |
create_list | <board_id> <name> | Create list |
update_list | <list_id> <name> | Rename list |
list_cards | <list_id> | Show cards in list |
get_card | <card_id> | Get card details |
create_card | <list_id> <name> [desc] | Create card |
move_card | <card_id> <list_id> | Move card to list |
delete_card | <card_id> | Delete card |
update_card_desc | <card_id> <desc> | Update description |
list_labels | <board_id> | Show board labels |
create_label | <board_id> <name> <color> | Create label |
add_label | <card_id> <label_id> | Add label to card |
remove_label | <card_id> <label_id> | Remove label |
create_checklist | <card_id> [name] | Add checklist |
add_checkitem | <checklist_id> <name> | Add checklist item |
list_checklists | <card_id> | Show checklists with items |
complete_checkitem | <card_id> <checklist_id> <item_id> | Mark item complete |
uncomplete_checkitem | <card_id> <checklist_id> <item_id> | Mark item incomplete |
Workflow
- Start with
list_boardsto get board IDs - Use
list_lists <board_id>to get list IDs - Use
list_cards <list_id>orcreate_cardas needed
Adding Cards with Checklists
When creating cards that need checklists (e.g., recipes with shopping lists):
- Create the card:
create_card <list_id> "Card Name" "Description" - Create a checklist:
create_checklist <card_id> "Checklist Name" - Add items:
add_checkitem <checklist_id> "Item name"
Example (recipe card):
# Create recipe card
python3 scripts/trello_api.py create_card <list_id> "Recipe Name" "Ingredients and steps..."
# Add shopping list checklist
python3 scripts/trello_api.py create_checklist <card_id> "Shopping List"
# Add ingredients as checklist items
python3 scripts/trello_api.py add_checkitem <checklist_id> "Ingredient 1"
python3 scripts/trello_api.py add_checkitem <checklist_id> "Ingredient 2"
Output Format
All output is optimized for minimal context:
- Lists show:
Name [id]per line - Cards show:
Name [id] - description_preview - Labels show:
Name [id] (color) - Checklists show items with
[x]or[ ]status - Mutations return:
Action message: new_id
Notes
- Requires
TRELLO_API_KEYandTRELLO_API_TOKENin environment - IDs are always shown in
[brackets]for easy extraction