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: bash export BRING_EMAIL="[email protected]" 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:
2. Items to add ("add milk and eggs to the list")
3. Items to remove ("remove milk from the list")
4. Checking the list ("what's on the shopping list?")

5. Item details/specs ("milk, but low fat" -> Milk:low fat)

6. Run the appropriate CLI command

7. Confirm the action naturally

Notes

• Requires BRING_EMAIL and BRING_PASSWORD environment variables
• Items can have optional specs via colon syntax: name:specification
• Uses the first (default) shopping list in the account
• Dependencies (bring-api, python-dotenv) are handled inline by uv run --with, or via pip install -r requirements.txt