# Migros MCP

> Migros MCP is an open-source MCP server for e-commerce. Unofficial local MCP server for Migros Switzerland products, stores, recipes and baskets. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/herp75/migros-mcp
- **MCP Registry name:** io.github.herp75/migros-mcp
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce), [food and drink](https://ai-powered.com/categories/food-and-drink)
- **Listing updated:** 2026-11-18

## About

This community fork adds security hardening, live tests and extra tools to an earlier Migros server. It ships as a Docker image that runs on your own computer, so it works in desktop clients that can launch a program, such as Claude Desktop, Claude Code and Cursor, but not in a browser or phone app.

Without an account you can search products, check nutrition and stock, find stores, see promotions and look up recipes. If you add your Migros login, it can also read and edit your basket and shopping lists, show past orders, in-store receipts and Cumulus points, and activate Cumulus coupons. It never places an order or pays; it hands you a checkout link to finish on migros.ch.

The README is blunt about limits: it is not made or supported by Migros, it uses the same internal addresses as the website and can break when they change, and the password sits in a file on your computer. A TOTP setup key can be added so you are never asked for 2FA codes.

## Features

- **Product and nutrition search:** Search products, details, stock and promotions without an account.
- **Stores and recipes:** Find nearby stores and recipes.
- **Basket and lists:** With a login, view and change your basket and shopping lists.
- **Orders and Cumulus:** Look up orders, receipts, points and coupons.
- **No automatic purchase:** It never orders or pays and only gives a checkout link.
- **Signed Docker image:** Images are signed with cosign so you can verify them.

## Good for

- Search for a product such as oat milk
- Add a recipe's ingredients to the basket
- Review how much you spent at Migros last month
- Activate a Cumulus coupon
- Find stores near a Swiss city

## Install

### Claude Code (Terminal)

```sh
claude mcp add migros-mcp --env MIGROS_PASSWORD='<MIGROS_PASSWORD>' --env MIGROS_TOTP_SECRET='<MIGROS_TOTP_SECRET>' -- docker run -i --rm -e MIGROS_PASSWORD -e MIGROS_TOTP_SECRET ghcr.io/herp75/migros-mcp:0.6.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "migros-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIGROS_PASSWORD",
        "-e",
        "MIGROS_TOTP_SECRET",
        "ghcr.io/herp75/migros-mcp:0.6.1"
      ],
      "env": {
        "MIGROS_PASSWORD": "<MIGROS_PASSWORD>",
        "MIGROS_TOTP_SECRET": "<MIGROS_TOTP_SECRET>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "migros-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIGROS_PASSWORD",
        "-e",
        "MIGROS_TOTP_SECRET",
        "ghcr.io/herp75/migros-mcp:0.6.1"
      ],
      "env": {
        "MIGROS_PASSWORD": "<MIGROS_PASSWORD>",
        "MIGROS_TOTP_SECRET": "<MIGROS_TOTP_SECRET>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "migros-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIGROS_PASSWORD",
        "-e",
        "MIGROS_TOTP_SECRET",
        "ghcr.io/herp75/migros-mcp:0.6.1"
      ],
      "env": {
        "MIGROS_PASSWORD": "<MIGROS_PASSWORD>",
        "MIGROS_TOTP_SECRET": "<MIGROS_TOTP_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "migros-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIGROS_PASSWORD",
        "-e",
        "MIGROS_TOTP_SECRET",
        "ghcr.io/herp75/migros-mcp:0.6.1"
      ],
      "env": {
        "MIGROS_PASSWORD": "<MIGROS_PASSWORD>",
        "MIGROS_TOTP_SECRET": "<MIGROS_TOTP_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "migros-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIGROS_PASSWORD",
        "-e",
        "MIGROS_TOTP_SECRET",
        "ghcr.io/herp75/migros-mcp:0.6.1"
      ],
      "env": {
        "MIGROS_PASSWORD": "<MIGROS_PASSWORD>",
        "MIGROS_TOTP_SECRET": "<MIGROS_TOTP_SECRET>"
      }
    }
  }
}
```

## FAQ

### Is it official?

No. The README says it is not made or supported by Migros and may break when Migros changes its addresses.

### Do I need a Migros account?

Not for search, stores, promotions or recipes; a login adds basket, orders and Cumulus.

### Can it buy things for me?

No. It never places an order or pays; you finish checkout on migros.ch.

### Does it work in a browser chat?

No. It runs locally and needs a desktop client plus Docker or Podman.

### Is Migros MCP free?

Yes. Migros MCP is open source, so you can use and self-host it for free.

### How do I add Migros MCP to Claude Code?

Run this command in your terminal: claude mcp add migros-mcp --env MIGROS_PASSWORD='<MIGROS_PASSWORD>' --env MIGROS_TOTP_SECRET='<MIGROS_TOTP_SECRET>' -- docker run -i --rm -e MIGROS_PASSWORD -e MIGROS_TOTP_SECRET ghcr.io/herp75/migros-mcp:0.6.1

### What are the best alternatives to Migros MCP?

The closest alternatives to Migros MCP are ChatGPT for Amazon, O'So MCP Server for PrestaShop, Ebid, Menus Recommender and Foodish.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [ChatGPT for Amazon](https://ai-powered.com/mcp/chatgpt_for_amazon): ChatGPT for Amazon is a freemium MCP server for marketing.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Ebid](https://ai-powered.com/mcp/ebid): Ebid is a freemium MCP server for e-commerce.
- [Menus Recommender](https://ai-powered.com/mcp/menus-recommender): Menus Recommender is an open-source MCP server for food and drink.
- [Foodish](https://ai-powered.com/mcp/foodish): Foodish is a freemium MCP server for food and drink.
- [Zovo Product Recall Check](https://ai-powered.com/mcp/zovo-product-recall-check): Zovo Product Recall Check is an MCP server for e-commerce.
- [Trackkr MCP Server — Smart Lockerless Parcel Management](https://ai-powered.com/mcp/trackkr-mcp-server-smart-lockerless-parcel-management): Trackkr MCP Server — Smart Lockerless Parcel Management is an MCP server for e-commerce.
- [Openfoodfacts](https://ai-powered.com/mcp/openfoodfacts): Openfoodfacts is a freemium MCP server for food and drink.

---
Source: https://ai-powered.com/mcp/migros-mcp
