bring-shopping

@masone⭐ 0 stars

Manage Bring! shopping lists — view lists, add/remove items, check off purchases. Use this skill whenever the user mentions shopping lists, groceries, Bring, adding items to buy, checking what's on the list, or anything related to grocery/shopping list management. Also trigger when the user wants to mark items as bought, remove things from a list, or add multiple items at once.

—/10

// RATINGS

⭐GitHub Stars

⭐ 0GitHub ↗

New / niche

🟢ProSkills Score

—

📍

Not yet listed on ClawHub or SkillsMP

// README

Bring! Shopping List Skill for Claude Code

A Claude Code skill for managing Bring! shopping lists — view lists, add/remove items, and check off purchases, all from your terminal.

Requirements

Python 3.11+
A Bring! account

Setup

Clone this repo (or add it as a skill directory):

git clone https://github.com/YOUR_USERNAME/bring-shopping-skill.git

Create a virtual environment and install dependencies:

cd bring-shopping-skill
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Configure your Bring! credentials:

cp .env.example .env
# Edit .env with your Bring! account email and password

Install as a Claude Code skill:

# Project-level (current project only)
mkdir -p .claude/skills
ln -s "$(pwd)" .claude/skills/bring

# OR user-level (all projects)
mkdir -p ~/.claude/skills
ln -s "$(pwd)" ~/.claude/skills/bring

Usage

Once installed, Claude will automatically use this skill when you mention shopping lists, groceries, or Bring. You can also invoke it explicitly with /bring.

Examples:

"What's on my shopping list?"
"Add milk, eggs, and bread to my Groceries list"
"Remove the bananas"
"I bought the milk and eggs"
"Add 2L of oat milk and organic butter to my list"

CLI Reference

The underlying CLI can also be used directly:

.venv/bin/python scripts/bring_cli.py lists                              # List all shopping lists
.venv/bin/python scripts/bring_cli.py items "Groceries"                  # Show items on a list
.venv/bin/python scripts/bring_cli.py add "Groceries" "Milk" --spec "2L" # Add an item with details
.venv/bin/python scripts/bring_cli.py add-batch "Groceries" Milk Eggs    # Add multiple items
.venv/bin/python scripts/bring_cli.py remove "Groceries" "Milk"          # Remove an item
.venv/bin/python scripts/bring_cli.py complete "Groceries" "Milk"        # Mark as bought

List names are resolved flexibly — case-insensitive, partial matching supported.

Credits

This skill is built on top of the bring-api Python library by miaucl and contributors. The library provides an unofficial async Python client for the Bring! shopping list API.

bring-api: MIT License, (c) miaucl — https://github.com/miaucl/bring-api
Bring! is a product of Bring! Labs AG. This skill is not affiliated with or endorsed by Bring! Labs AG.