majiayu000 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