Bring Mcp
MCP Server for Bring! Shopping
This project implements a local Model Context Protocol (MCP) server in TypeScript that exposes the functionalities of the Bring! shopping list API. It enables applications like Claude Desktop to interact with your Bring! shopping lists using standardized MCP tools.
The server integrates the bring-shopping npm package for Bring! API access and uses the MCP TypeScript SDK v2 server package to provide an MCP-compliant interface.
Disclaimer:
This is a personal project. I am not affiliated with Bring! Labs AG in any way.
This project uses an unofficial Bring! API, which may change or be blocked at any time.
This could cause the MCP server to stop functioning without prior notice.
🧩 Recommended Claude Desktop Configuration
To use this server in Claude Desktop via npx, insert the following into your claude_desktop_config.json file:
{
"mcpServers": {
"bring-mcp": {
"command": "npx",
"args": ["-y", "bring-mcp@latest"],
"env": {
"BRING_EMAIL": "your_bring_email@example.com",
"BRING_PASSWORD": "YOUR_BRING_PASSWORD_HERE"
}
}
}
}
This is the recommended and most portable configuration. It ensures you always use the latest version published to npm without needing local installation.
💬 Using with ChatGPT via OpenAI Secure MCP Tunnel
OpenAI Secure MCP Tunnel lets ChatGPT reach this STDIO server without exposing it through a public endpoint. The tunnel client itself is provided as a downloadable binary, while bring-mcp can still be launched through npx without a local checkout or installation.
Prerequisites
- Node.js 22 or newer, including
npm/npx - ChatGPT developer-mode access
Tunnels Read + Usepermissions in the relevant OpenAI Platform organization- A tunnel ID and runtime API key from OpenAI Platform tunnel settings
- The
tunnel-clientbinary, available from the download link in the tunnel settings
When creating the tunnel, associate it with the ChatGPT workspace in which you want to use Bring. Otherwise, it will not appear when creating the ChatGPT connection.
Configure and run the tunnel
Export the tunnel API key and your Bring! credentials in the shell that will run tunnel-client:
export CONTROL_PLANE_API_KEY="sk-..."
export BRING_EMAIL="your_bring_email@example.com"
export BRING_PASSWORD="YOUR_BRING_PASSWORD_HERE"
Create a tunnel profile that starts the latest published bring-mcp package through npx:
tunnel-client init \
--sample sample_mcp_stdio_local \
--profile bring-mcp \
--tunnel-id tunnel_0123456789abcdef0123456789abcdef \
--mcp-command "npx -y bring-mcp@latest"
Validate the configuration, then start the tunnel:
tunnel-client doctor --profile bring-mcp --explain
tunnel-client run --profile bring-mcp
Keep this process running while using the integration. The environment variables above are inherited by the npx-started MCP server.
Connect the tunnel in ChatGPT
- In ChatGPT, open Settings → Security and login and enable Developer mode.
- Open ChatGPT Plugins and select the plus button to create a developer-mode app.
- Enter a name and description, choose Tunnel under Connection, and select the tunnel created above (or enter its
tunnel_id). - Create the connection and review the 16 discovered Bring! tools.
- Start a new chat, enable the Bring connection from the tools menu, and try a request such as “Show my Bring shopping lists.”
From the project's README.