🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Bring! Shoppinglist

by @joekravelli

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

Versionv1.0.1
Downloads263
TERMINAL
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

  • 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.

    πŸ’‘ 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

  • 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.