weneed-mcp

weneed-mcp

Manage your WeNeed (Coop Switzerland) shopping lists with Claude. Add items, check them off, search the Coop catalog, and more.

Important This is not an official MCP server and is not affiliated with Coop or WeNeed in any way. It uses a reverse-engineered Firebase backend and may stop working at any time if Coop changes their infrastructure. Use at your own risk.

What you can do

Once installed, just talk to Claude naturally:

• "What's on my shopping list?"
• "Add milk and eggs to my list"
• "Check off the bananas"
• "Search the catalog for gluten-free pasta"
• "Remove the yogurt from my list"

Note: If you use shared lists, actions taken through this server will be visible to all participants.

Install

You need a WeNeed account (email/password) to use this.

Claude Desktop (recommended)

• Download weneed-mcp.mcpb

• Install it:

  macOS - Double-click the file, or drag and drop it onto the Claude Desktop app icon

  Windows - In Claude Desktop, go to File > Settings > Extensions > Advanced Settings > Install Extension and select the file

• Enter your WeNeed email and password when prompted. Your credentials are stored securely in your OS keychain.

That's it. You're ready to go.

Advanced setup

These methods require Node.js 18+ installed on your machine.

Claude Code

claude mcp add weneed -e WENEED_EMAIL=[e-mail] \
  -e WENEED_PASSWORD=your-password -- npx -y weneed-mcp

Claude Desktop (manual) / Cursor

Add the following to your config file:

• Claude Desktop - claude_desktop_config.json
• Cursor - .cursor/mcp.json (project) or ~/.cursor/mcp.json (global)

{
  "mcpServers": {
    "weneed": {
      "command": "npx",
      "args": ["-y", "weneed-mcp"],
      "env": {
        "WENEED_EMAIL": "[e-mail]",
        "WENEED_PASSWORD": "your-password"
      }
    }
  }
}

Test connection

Verify your credentials work before wiring it into a client:

WENEED_EMAIL='[e-mail]' WENEED_PASSWORD='your-password' npx weneed-mcp

Available tools

Tool	Description
get_shopping_lists	Get all shopping lists you have access to, including shared lists
get_list_items	Get all active items in a specific shopping list
add_item	Add a product to a shopping list by name
check_item	Mark an item as checked/bought
uncheck_item	Uncheck a previously checked item
remove_item	Remove (deactivate) an item from a list
search_catalog	Search the Coop product catalog
get_categories	Get product categories from the Coop catalog

How it works

WeNeed is a Progressive Web App backed by Firebase (Firestore + Cloud Functions). This MCP server authenticates with your credentials using the Firebase JS SDK, then reads/writes directly to the same Firestore collections and calls the same Cloud Functions that the official app uses.

Your credentials are only sent to Firebase/Google's authentication servers. They are never stored or transmitted anywhere else.

Development

git clone https://github.com/lewpgs/weneed-mcp.git
cd weneed-mcp
npm install
npm run build
node dist/index.js

Debug with the MCP Inspector:

WENEED_EMAIL='[e-mail]' WENEED_PASSWORD='your-password' \
  npx -y @modelcontextprotocol/inspector npx weneed-mcp

Disclaimers

• Unofficial - This project is not affiliated with, endorsed by, or connected to Coop or WeNeed in any way.
• Reverse-engineered API - This server interacts with WeNeed's Firebase backend, which is not a public API. Changes to Coop's Firebase project, Firestore security rules, or Cloud Functions could break this server without notice.
• Credentials - Your email and password are only used to authenticate with Firebase/Google. They are never stored or sent anywhere else.
• Shared lists - If you use shared shopping lists, actions taken through this MCP server (adding, checking, removing items) will be visible to all participants.
• Use at your own risk - No guarantees of functionality, availability, or compatibility.

License

MIT