Bring

Exposes Bring! shopping list operations as MCP tools with auto authentication and stdio communication.

typescript

6

GitHub Stars

typescript

Language

3 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You set up a local MCP server that exposes Bring! shopping list functionalities through a standardized MCP interface. It lets client apps interact with your Bring! lists automatically and securely, using the familiar MCP tooling ecosystem.

How to use

You connect to the local Bring! MCP server from your MCP client by configuring one or more MCP servers in your client’s setup. This server exposes a set of actions such as loading lists, retrieving and updating items, handling images, managing list members, and loading translations and catalogs. Use the configured server to perform common shopping list tasks without direct Bring! account handling in your client. Authentication happens automatically on first API call, so you don’t need to log in each time.

How to install

Prerequisites you need before installing: Node.js and npm, and access to the internet to pull dependencies.

Step 1: Install dependencies for the project.

Additional sections

Configuration and usage details are provided below in concrete examples you can copy into your client configuration.

Available tools

loadLists

Load all shopping lists from Bring!

getItems

Get all items from a specific shopping list

getItemsDetails

Get details for items in a list

saveItem

Save an item to a shopping list with optional specification

saveItemBatch

Save multiple items to a shopping list in one operation

removeItem

Remove an item from a specific shopping list

moveToRecentList

Move an item to the recently used items list

deleteMultipleItemsFromList

Delete multiple items from a list by their names

saveItemImage

Save an image for an item on a shopping list

removeItemImage

Remove an image from an item

getAllUsersFromList

Get all users associated with a shopping list

getUserSettings

Get settings for the authenticated user

getDefaultList

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

loadTranslations

Load translations for the Bring! interface

loadCatalog

Load the Bring! item catalog

getPendingInvitations

Get pending invitations to join shopping lists