Bring! Shoppinglist

Manage Bring! shopping lists via CLI to add, remove, complete, and view items or lists using the 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:

   bash

   python3 -m pip install bring-api
   

2. Configure credentials — set env vars BRING_EMAIL and BRING_PASSWORD, or create ~/.openclaw/credentials/bring.json:

   json

   {
     "email": "[e-mail]",
     "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

bash

python3 scripts/bring.py list

Show items in a list

bash

python3 scripts/bring.py items
python3 scripts/bring.py items --list "Einkauf"

Add an item

bash

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

bash

python3 scripts/bring.py remove "Milch"
python3 scripts/bring.py remove "Milch" --list "Einkauf"

Complete (check off) an item

bash

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 list first and ask the user to confirm.

Troubleshooting

• Authentication failed: Check email/password in ~/.bring.json or env vars. Bring! uses the email from the app account settings.
• List not found: List names are case-insensitive but must match exactly. Use list to 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 lists
• get_list(listUuid) → items in one list
• batch_update_list(listUuid, item, ADD) → add item
• batch_update_list(listUuid, item, REMOVE) → remove item
• batch_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.