Bring! Shopping Lists
by @zahlmann
Manage your Bring! shopping list by adding, removing, completing items, or checking the current groceries via your Bring! account.
clawhub install bring-shopping-listπ About This Skill
name: bring-shopping-list description: Use when asked about the shopping list, groceries, "add to shopping list", "what's on the list", "remove from list", or any shopping/grocery related request. Integrates with the Bring! shopping list app. argument-hint: "[add|remove|list] [items...]" user-invocable: false metadata: openclaw: requires: env: - BRING_EMAIL - BRING_PASSWORD bins: - uv primaryEnv: BRING_EMAIL
Bring! Shopping List
Manage a Bring! shopping list β add items, remove items, mark items as completed, and check what's on the list.
Setup
1. Install uv if not already installed 2. Set environment variables for your Bring! account:
export BRING_EMAIL="your-email@example.com"
export BRING_PASSWORD="your-password"
Or add them to a .env file in your project root.> If you use Google login for Bring!, go to your Bring! account settings and set a separate password first.
Usage
All commands use bring.py in this skill's directory. Adjust the path based on where you installed the skill.
With uv (recommended)
uv run --with bring-api --with python-dotenv python bring.py list --json
uv run --with bring-api --with python-dotenv python bring.py add "Milk" "Eggs" "Butter:Irish"
uv run --with bring-api --with python-dotenv python bring.py remove "Milk"
uv run --with bring-api --with python-dotenv python bring.py complete "Eggs"
With pip
pip install -r requirements.txt
python bring.py list --json
python bring.py add "Milk" "Eggs" "Butter:Irish"
python bring.py remove "Milk"
python bring.py complete "Eggs"
Handling Requests
1. Parse the user's message for:
- Items to add ("add milk and eggs to the list")
- Items to remove ("remove milk from the list")
- Checking the list ("what's on the shopping list?")
- Item details/specs ("milk, but low fat" -> Milk:low fat)
2. Run the appropriate CLI command
3. Confirm the action naturally
Notes
BRING_EMAIL and BRING_PASSWORD environment variablesname:specificationbring-api, python-dotenv) are handled inline by uv run --with, or via pip install -r requirements.txtπ‘ Examples
All commands use bring.py in this skill's directory. Adjust the path based on where you installed the skill.
With uv (recommended)
uv run --with bring-api --with python-dotenv python bring.py list --json
uv run --with bring-api --with python-dotenv python bring.py add "Milk" "Eggs" "Butter:Irish"
uv run --with bring-api --with python-dotenv python bring.py remove "Milk"
uv run --with bring-api --with python-dotenv python bring.py complete "Eggs"
With pip
pip install -r requirements.txt
python bring.py list --json
python bring.py add "Milk" "Eggs" "Butter:Irish"
python bring.py remove "Milk"
python bring.py complete "Eggs"
βοΈ Configuration
1. Install uv if not already installed 2. Set environment variables for your Bring! account:
export BRING_EMAIL="your-email@example.com"
export BRING_PASSWORD="your-password"
Or add them to a .env file in your project root.> If you use Google login for Bring!, go to your Bring! account settings and set a separate password first.
π Tips & Best Practices
BRING_EMAIL and BRING_PASSWORD environment variablesname:specificationbring-api, python-dotenv) are handled inline by uv run --with, or via pip install -r requirements.txt