Bring! Shoppinglist
by @joekravelli
Manage Bring! shopping lists via CLI to add, remove, complete, and view items or lists using the Bring! API.
clawhub install bring-appπ About This Skill
name: bring-shopping-list description: Manage Bring! shopping lists via CLI β add, remove, complete, and list items. Use when the user wants to interact with Bring! grocery/shopping lists: add items, remove items, check items off, view list contents, or list available shopping lists. Also matches phrases like "bring list", "shopping list", "Einkaufsliste", "add to shopping list", "Bring! API".
Bring! Shopping List Skill
Manage Bring! shopping lists using the bring-api Python package via a bundled CLI script.
Setup (one-time)
1. Install the Python dependency:
python3 -m pip install bring-api
2. Configure credentials β set env vars BRING_EMAIL and BRING_PASSWORD, or create ~/.openclaw/credentials/bring.json:
{
"email": "your@email.com",
"password": "your_password"
}
3. (Optional) Set a default list via env var BRING_LIST (matches list title, case-insensitive).
Usage
All commands use the bundled script scripts/bring.py.
List all shopping lists
python3 scripts/bring.py list
Show items in a list
python3 scripts/bring.py items
python3 scripts/bring.py items --list "Einkauf"
Add an item
python3 scripts/bring.py add "Milch"
python3 scripts/bring.py add "Milch" --spec "fettarm"
python3 scripts/bring.py add "Zitronen" --list "Party"
Remove an item
python3 scripts/bring.py remove "Milch"
python3 scripts/bring.py remove "Milch" --list "Einkauf"
Complete (check off) an item
python3 scripts/bring.py complete "Milch"
python3 scripts/bring.py complete "Milch" --list "Einkauf"
Common Patterns
add.remove.complete.items.--list "Name" to target the right one.list first and ask the user to confirm.Troubleshooting
~/.bring.json or env vars. Bring! uses the email from the app account settings.list to see available names.python3 -m pip install bring-api.API Reference
Based on miaucl/bring-api (unofficial Bring! API, MIT license).
The CLI wraps these core API methods:
load_lists() β all shopping listsget_list(listUuid) β items in one listbatch_update_list(listUuid, item, ADD) β add itembatch_update_list(listUuid, item, REMOVE) β remove itembatch_update_list(listUuid, item, COMPLETE) β check off itemLicense
This skill uses the MIT-licensed bring-api package. Bring! trademarks belong to Bring! Labs AG. This is not affiliated with or endorsed by Bring! Labs AG.
π‘ Examples
All commands use the bundled script scripts/bring.py.
List all shopping lists
python3 scripts/bring.py list
Show items in a list
python3 scripts/bring.py items
python3 scripts/bring.py items --list "Einkauf"
Add an item
python3 scripts/bring.py add "Milch"
python3 scripts/bring.py add "Milch" --spec "fettarm"
python3 scripts/bring.py add "Zitronen" --list "Party"
Remove an item
python3 scripts/bring.py remove "Milch"
python3 scripts/bring.py remove "Milch" --list "Einkauf"
Complete (check off) an item
python3 scripts/bring.py complete "Milch"
python3 scripts/bring.py complete "Milch" --list "Einkauf"
π Tips & Best Practices
~/.bring.json or env vars. Bring! uses the email from the app account settings.list to see available names.python3 -m pip install bring-api.