mcp-bring

An MCP (Model Context Protocol) server for the Bring! shopping list app. Lets Claude and other AI assistants read and manage your Bring! shopping lists.

⚠️ Unofficial API: This uses the reverse-engineered Bring! API. Not affiliated with Bring! Labs AG.

What it does

Talk to your shopping list naturally:

• "What's on my shopping list?"

• "Add milk, eggs, and oat milk to the grocery list"

• "Mark butter as purchased"

• "Add all ingredients for pasta carbonara to my list"

Related MCP server: lista-compras-mcp

Available Tools

Setup

1. Prerequisites

• Python 3.12+

• uv (recommended) or pip

• A Bring! account

2. Install

# Clone or copy this project
cd mcp-bring

# Install with uv
uv pip install -e .

# Or with pip
pip install -e .

3. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bring": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/mcp-bring", "mcp-bring"],
      "env": {
        "BRING_EMAIL": "your@email.com",
        "BRING_PASSWORD": "your_password"
      }
    }
  }
}

Replace /path/to/mcp-bring with the actual path to this directory.

4. Restart Claude Desktop

Quit and reopen Claude Desktop. You should see "Bring! Shopping Lists" in the tools available.

Development

# Install dev deps
uv pip install -e ".[dev]"

# Test the server interactively
fastmcp dev src/mcp_bring/server.py

# Run tests
pytest

# Lint
ruff check src/

Environment Variables

List Allowlist (BRING_LIST_ALLOWLIST)

By default the server exposes all your Bring! lists. Set BRING_LIST_ALLOWLIST to limit which lists Claude can see and interact with.

# Restrict to a single list by name
BRING_LIST_ALLOWLIST=Groceries

# Multiple lists (names, UUIDs, or a mix)
BRING_LIST_ALLOWLIST=Groceries,Hardware Store
BRING_LIST_ALLOWLIST=Groceries,a1b2c3d4-e5f6-7890-abcd-ef1234567890

When the allowlist is active:

• get_lists returns only the allowed lists

• Any tool that targets a list UUID not on the allowlist returns a clear error

The allowlist is resolved once at startup — list names are looked up and converted to UUIDs, so renaming a list in the Bring! app requires a server restart to pick up the change.

To use it with Claude Desktop, add it to the env block:

{
  "mcpServers": {
    "bring": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/mcp-bring", "mcp-bring"],
      "env": {
        "BRING_EMAIL": "your@email.com",
        "BRING_PASSWORD": "your_password",
        "BRING_LIST_ALLOWLIST": "Groceries"
      }
    }
  }
}

Troubleshooting

"Authentication failed" — Check your email/password. Note: if you use social login (Google/Apple), you may need to set a Bring! password separately.

"Missing credentials" — Make sure BRING_EMAIL and BRING_PASSWORD are set in the Claude Desktop config env block.

Server not appearing in Claude Desktop — Check the config JSON is valid, restart Claude Desktop, check logs at ~/Library/Logs/Claude/.

License

MIT