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="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)

bash
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

bash
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)

1. Run the appropriate CLI command

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