Bring! Shoppinglist
/install bring-app
Bring! Shopping List Skill
Manage Bring! shopping lists using the bring-api Python package via a bundled CLI script.
Setup (one-time)
-
Install the Python dependency:
python3 -m pip install bring-api -
Configure credentials — set env vars
BRING_EMAILandBRING_PASSWORD, or create~/.openclaw/credentials/bring.json:{ "email": "[email protected]", "password": "your_password" } -
(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
- When the user says "add X to shopping list", extract the item name and optional spec, then call
add. - When the user says "remove X from shopping list", call
remove. - When the user says "check off X" or "done with X", call
complete. - When the user says "show shopping list" or "what's on the list", call
items. - If the user has multiple lists, use
--list "Name"to target the right one. - If unsure which list, call
listfirst and ask the user to confirm.
Troubleshooting
- Authentication failed: Check email/password in
~/.bring.jsonor env vars. Bring! uses the email from the app account settings. - List not found: List names are case-insensitive but must match exactly. Use
listto see available names. - Item not found: Item matching is case-insensitive. If duplicates exist, the first match is used.
- ModuleNotFoundError: Run
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 item
License
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.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bring-app - After installation, invoke the skill by name or use
/bring-app - Provide required inputs per the skill's parameter spec and get structured output
What is Bring! Shoppinglist?
Manage Bring! shopping lists via CLI to add, remove, complete, and view items or lists using the Bring! API. It is an AI Agent Skill for Claude Code / OpenClaw, with 28 downloads so far.
How do I install Bring! Shoppinglist?
Run "/install bring-app" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Bring! Shoppinglist free?
Yes, Bring! Shoppinglist is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Bring! Shoppinglist support?
Bring! Shoppinglist is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Bring! Shoppinglist?
It is built and maintained by JoeKravelli (@joekravelli); the current version is v1.0.0.