MCP Server for Bring! Shopping

@florianwittkamp

Repository

Basic information

About MCP Server for Bring! Shopping

#mcp#shopping-list#bring#bring-shopping#mcp-server

MCP Server for Bring! Shopping config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bring-mcp@latest"
      ],
      "env": {
        "MAIL": "your_bring_email@example.com",
        "PW": "YOUR_BRING_PASSWORD_HERE"
      }
    }
  }
}

MCP Server for Bring! Shopping tools

Load all shopping lists from Bring!

Get all items from a specific shopping list

Get details for items in a list

Save an item to a shopping list with optional specification

Save multiple items to a shopping list in one operation

Remove an item from a specific shopping list

Move an item to the recently used items list

Delete multiple items from a list by their names

Save an image for an item on a shopping list

Remove an image from an item

Get all users associated with a shopping list

Get settings for the authenticated user

Get the UUID of the default shopping list (use when user doesn't specify a list)

Load translations for the Bring! interface

Load the Bring! item catalog

Get pending invitations to join shopping lists

Overview

What is MCP Server for Bring! Shopping?

It is a local MCP server in TypeScript that exposes the Bring! shopping list API as standardized MCP tools, enabling applications like Claude Desktop to interact with your Bring! shopping lists.

How to use MCP Server for Bring! Shopping?

Install dependencies with npm install, create a .env file with MAIL and PW, then build with npm run build. Run with node build/src/index.js. For Claude Desktop, configure claude_desktop_config.json to use npx -y bring-mcp@latest with environment variables MAIL and PW.

Key features of MCP Server for Bring! Shopping

Automatic authentication on first API call
Load shopping lists and get item details
Add, remove, and move items on lists
Batch operations for multiple items
Save and remove item images
Manage list users and retrieve pending invitations

Use cases of MCP Server for Bring! Shopping

Manage Bring! shopping lists directly from Claude Desktop
Automate adding or removing items from a shared list
Batch update multiple items in a single operation
Retrieve default list UUID and list user information
Load translations and the item catalog for localization

Frequently asked questions

What dependencies are required?

It depends on `@modelcontextprotocol/sdk`, `bring-shopping`, `zod`, and `dotenv`. Node.js is needed to run the server.

How does authentication work?

Authentication is automatic on the first API call using the email and password provided in the `MAIL` and `PW` environment variables or `.env` file. No manual login is required.

Where does my data live?

The server runs locally and communicates with the Bring! API over the internet. Your Bring! credentials and list data are processed on your machine and sent to Bring! servers via their unofficial API.

Is this project affiliated with Bring! Labs AG?

No. This is a personal project and is not affiliated with Bring! Labs AG. It uses an unofficial Bring! API that may change or be blocked at any time.

What transport and configuration does the server use?

The server communicates via STDIO, making it compatible with Claude Desktop and MCP Inspector. It can be configured using `npx` (recommended) or a local build.

Comments

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40