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

1. Start with list_boards to get board IDs
2. Use list_lists <board_id> to get list IDs
3. Use list_cards <list_id> or create_card as needed

Adding Cards with Checklists

When creating cards that need checklists (e.g., recipes with shopping lists):

1. Create the card: create_card <list_id> "Card Name" "Description"
2. Create a checklist: create_checklist <card_id> "Checklist Name"
3. 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_KEY and TRELLO_API_TOKEN in environment
• IDs are always shown in [brackets] for easy extraction