Skip to main content
Glama
my-grocery-mcp

my-grocery-mcp

by yifei-ding

my-grocery-mcp

Personal MCP server for Swiss grocery product search, price comparison and weekly promotions (Migros, Coop, Aldi, Denner, Lidl, Farmy, Volgshop, Otto's).

Origin and license

Forked from nicktcode/swissgroceries-mcp at v0.7.4, the last release under the MIT License. Later upstream releases use different licenses; no code from them is included here. This project stays under MIT — see LICENSE. The original README is kept as UPSTREAM-README.md for reference on tools and setup.

Not affiliated with any of the retailers. It calls their publicly reachable app/web endpoints; those can change without notice.

Related MCP server: PriceAtlas MCP Server

Changes since the fork

See git log. Highlights:

  • Migros: promotions with a minimum quantity ("40% Ab 2 Stück") are detected.

  • Migros: get_promotions reads the full weekly list and honours query.

  • Migros: search_products keeps promotion data.

  • Migros: default region is Zürich (2), overridable via MIGROS_REGION.

Run locally

npm install
npm test
npm run build

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "my-grocery": {
      "command": "node",
      "args": ["/absolute/path/to/my-grocery-mcp/dist/index.js"]
    }
  }
}

Available Tools

7 tools
find_stockA

Check which stores of a given chain have a specific product in stock. Optionally filter by proximity to GPS coordinates or query a single store by ID. Not all chains support per-store stock queries; unsupported chains return a clear error. Use for "is this product available near Zurich HB?", "which Coop has item X in stock?".

Inputs: chain (required), productId (required), near, storeId.

find_storesA

Find grocery stores near a location, filtered by chain and search radius. Accepts a Swiss ZIP code, GPS coordinates, or a free-text address as the search center. Returns store name, address, chain, location, and opening hours where available. Use for "find a Migros near me", "which Coop branches are in 8001?", or before checking stock.

Inputs: near (required), chains, radiusKm.

get_productA

Fetch full product details for a specific chain + product ID pair. Returns price, brand, size, unit price, tags, category, image URL, and active promotions. Obtain product IDs from search_products. Useful for drilling into a search result. Use for "get details for this Migros product" or "what is the unit price of this item?".

Inputs: id (required), chain (required).

get_promotionsA

List current promotional deals across configured Swiss grocery chains. Filter by chain, keyword, store ID, or how many days until the promotion expires. Returns promotion name, discount, validity dates, and applicable stores. Use for "what is on sale this week?", "any Migros deals on cheese?", or "promotions ending today".

Inputs: query, chains, storeIds, endingWithinDays.

health_checkA

Probe each registered chain adapter with a trivial query and report status, latency, and capability flags. Use this when a chain seems missing from results or when debugging adapter problems.

Inputs: chains, timeoutMs.

plan_shoppingA

Plan a multi-store shopping trip near a location, picking the best products across configured Swiss grocery chains. Items can be generic ("milch", "pasta") or pinned to a specific SKU. Returns a primary plan plus alternatives. Use when the user gives a list of items and asks "where should I shop?" or "what's cheapest?". Strategies: single_store (one chain), split_cart (multi-chain with stop penalty), absolute_cheapest (no penalty).

Inputs: near (required), items (required), strategy (required), chains, +2 more.

search_productsA

Search for products across configured Swiss grocery chains (Migros, Coop, Aldi, Denner, Lidl) by keyword. Supports optional filters for price, size range, and product tags (organic, vegan, budget, etc.). Returns results grouped by chain with normalised price, unit price, size, and promotion info. Use for "find organic milk under 2 CHF", "compare pasta prices", or "search for gluten-free bread".

Inputs: query (required), limit, chains, offset, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: store discovery, product search, product detail, promotions, per-store stock, adapter diagnostics, and multi-item trip planning. The only mild conceptual overlap (search_products vs plan_shopping) is clearly separated by scope—single-product search versus multi-item itinerary optimization.

    Naming Consistency5/5

    All seven tools follow a consistent snake_case verb_noun pattern (find_stores, search_products, get_product, get_promotions, find_stock, plan_shopping), with health_check being the only noun-ish exception but still readable and idiomatic.

    Tool Count5/5

    Seven tools is well-scoped for a Swiss grocery comparison server, covering discovery, search, detail, promotions, stock, diagnostics, and planning without redundancy. Each tool earns its place in the workflow.

    Completeness4/5

    The surface covers the core lifecycle: find stores, search products, inspect details, check promotions and stock, and plan trips, plus a health check for adapter issues. Minor gaps exist—no explicit chain/capability listing beyond health_check, no store-detail-by-ID tool, and no price history—but these are workable around.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to track global food prices, search products by barcode or name, and compare costs across 27 countries. It provides tools for real-time price scraping and data aggregation from major international supermarket chains.
      8
      4
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      A Model Context Protocol server for real-time Swiss grocery shopping that searches and compares products across 8 major Swiss retailers (Migros, Coop, Aldi, Denner, Lidl, Farmy, Volgshop, Otto’s), normalizes per-unit prices, surfaces promotions, computes optimal multi-store shopping plans, and works with any MCP-compatible client without API keys or accounts.
      7
      255 npm
      44
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables searching products, comparing prices, and building optimal shopping lists across major Chilean supermarkets, using your local machine to access real-time prices and loyalty deals.
      14
      68 npm
      67
      MIT