my-grocery-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@my-grocery-mcp find the cheapest butter across Migros, Coop, and Aldi"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_promotionsreads the full weekly list and honoursquery.Migros:
search_productskeeps promotion data.Migros: default region is Zürich (
2), overridable viaMIGROS_REGION.
Run locally
npm install
npm test
npm run buildClaude 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 toolsfind_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Compare prices across Swiss and European shops — barcode (GTIN) lookup and daily price history.
Live prices, deals & optimal multi-stop shopping routes for German grocery & drug stores.
Pay-per-call Swiss retail price intelligence (22 retailers). $0.01 USDC via x402.
Search Coles, Woolworths and ALDI at once: prices, unit prices, specials, cheapest store per item.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides grocery price and nutritional information search capabilities, allowing AI agents to search for food products, compare prices, and analyze nutritional content across different grocery stores.1-
- AlicenseAqualityDmaintenanceEnables 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.84MIT
- FlicenseAqualityBmaintenanceA 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.7255 npm44-
- AlicenseAqualityBmaintenanceEnables 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.1468 npm67MIT