migros-mcp

Search Migros products and (optionally) manage your basket, addresses, and orders through Claude.

Important This is not affiliated with Migros in any way. It uses publicly accessible API endpoints. There is no official Migros API. It can break at any time if Migros changes their endpoints. Use at your own risk.

What you can do

Without an account (anonymous access):

• "Search Migros for protein bars"
• "What's the nutrition info for this Migros product?"
• "Find Migros stores near Zurich"
• "What promotions does Migros have right now?"
• "Compare the protein content of these two products"
• "Find me a recipe for risotto and add the ingredients to my basket" (combines anonymous recipe search with authenticated cart write)

With your Migros account (optional):

• "What's currently in my Migros basket?"
• "Add 2 liters of milk to my basket"
• "Remove the bananas from my basket"
• "Where will my order be delivered to?"
• "Show me my last 5 Migros orders"
• "Give me the link to finish my checkout"
• "How much did I spend at Migros last month?"
• "What was on my last in-store receipt?"
• "Which Cumulus coupons do I have right now?"
• "How many Cumulus points do I have?"

The basket and order tools require your Migros account credentials. They're optional — if you skip them at install, the anonymous tools still work.

Install

Claude Desktop (recommended)

1. Download migros-mcp.mcpb

2. 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

3. Optional: enter your Migros email, password, and TOTP secret if you want the basket/order tools. Leave all three blank for anonymous access only. Credentials are stored in your OS keychain by Claude Desktop.

   About the TOTP secret. This is NOT the rotating 6-digit code your authenticator app shows. It is the static base32 seed given to you (or scanned via QR code) when you originally set up the authenticator. It's a one-time value, typically ~32 characters of A-Z2-7 (for example: JBSWY3DPEHPK3PXP3PXP3PXP3PXP3PXP), and it doesn't change every 30 seconds.

   How to find it:

   • If you saved it during enrollment — copy it from your password manager. In 1Password / Bitwarden / Proton Pass, open the Migros entry, edit the OTP field, choose "View one-time password secret" (or similar). The string after secret= is what you want.

   • If you didn't save it — Migros only shows the seed during initial 2FA setup, on the same screen as the QR code, in a box labeled "Or enter the following key in the authenticator app:". Once enrollment completes, the seed is gone for good.

     To recover it: in Migros account settings, remove your existing 2FA, then set it up again. The new setup screen will show the new seed text below the QR code — copy it before completing enrollment, and re-add the new entry to your authenticator app.

   Leave the field blank entirely if your Migros account doesn't have 2FA enabled.

That's it.

Advanced setup

These methods require Node.js 18+.

Claude Code

# Anonymous (search/browse only)
claude mcp add migros -- npx -y migros-mcp

# With your account (basket + orders)
claude mcp add migros \
  -e MIGROS_EMAIL=you@example.com \
  -e MIGROS_PASSWORD='your-password' \
  -e MIGROS_TOTP_SECRET=ABCDEFGHIJKLMNOP \
  -- npx -y migros-mcp

Claude Desktop (manual) / Cursor

Add to your config:

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

{
  "mcpServers": {
    "migros": {
      "command": "npx",
      "args": ["-y", "migros-mcp"],
      "env": {
        "MIGROS_E

... [View full README on GitHub](https://github.com/lewpgs/migros-mcp#readme)