MCP Server for Bring! Shopping

Name: MCP Server for Bring! Shopping
Author: florianwittkamp

@florianwittkamp

代码仓库

关于 MCP Server for Bring! Shopping

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

基本信息

分类

其他

许可证

MIT license

运行时

node

传输方式

stdio

发布者

florianwittkamp

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "bring-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bring-mcp@latest"
      ],
      "env": {
        "MAIL": "[email protected]",
        "PW": "YOUR_BRING_PASSWORD_HERE"
      }
    }
  }
}

工具

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

概览

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.