Bring Mcp

MCP Server for Bring! Shopping

LLM Mart 0 views 66 listing impressions

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 + Use permissions in the relevant OpenAI Platform organization
  • A tunnel ID and runtime API key from OpenAI Platform tunnel settings
  • The tunnel-client binary, 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

  1. In ChatGPT, open Settings → Security and login and enable Developer mode.
  2. Open ChatGPT Plugins and select the plus button to create a developer-mode app.
  3. Enter a name and description, choose Tunnel under Connection, and select the tunnel created above (or enter its tunnel_id).
  4. Create the connection and review the 16 discovered Bring! tools.
  5. 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.

Related servers

Read and write RAGE Package Format archives

23 views

See how ChatGPT, Claude, Gemini and Perplexity read any website. Scored out of 100.

19 views

MCP server for Geargrafx PC Engine / TurboGrafx-16 emulator

19 views

Read-only on-chain intel for AI agents on Base: balances, tokens, gas, tx status. No API keys.

15 views