MCP Server for Bring! Shopping

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

FAQ from MCP Server for Bring! Shopping

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.