Bring! Shoppinglist

Manage Bring! shopping lists via CLI to add, remove, complete, and view items or lists using the Bring! API.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisReview

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills 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_EMAIL and BRING_PASSWORD, or create ~/.openclaw/credentials/bring.json:
```
{
  "email": "your@email.com",
  "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 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.