rewe-mcp
Integrates with REWE Germany to search supermarkets, browse weekly discounts and brochures, search products, explore recipes, inspect digital eBon receipts and online orders, check REWE Bonus balance and coupons, manage favorites and Pickup/Delivery baskets, and plan grocery trips.
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., "@rewe-mcp show me this week's REWE discounts and my Bonus coupons"
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.
rewe-mcp
Model Context Protocol (MCP) server for REWE (Germany). Search supermarkets, browse weekly discounts (Angebote) and brochures (Prospekte), search the product catalog, explore recipes, inspect digital eBon receipts and online order history, check your REWE Bonus balance and coupons, manage favorites and Pickup/Delivery baskets, and plan grocery trips.
Quick Start
1. Install & Build
npm install
npm run build2. Configure the mTLS Client Certificate (Required)
REWE's mobile backend (https://mobile-clients-api.rewe.de and https://msco.rewe.de) requires a client certificate and private key during the TLS handshake. The certificate and private key must be extracted from the REWE Android APK and placed as certificate.pem and private.key in ~/.config/rewe-mcp/certs/ with 0600 permissions:
mkdir -p ~/.config/rewe-mcp/certs
chmod 600 ~/.config/rewe-mcp/certs/certificate.pem ~/.config/rewe-mcp/certs/private.keyAlternatively, set REWE_MTLS_CERT and REWE_MTLS_KEY to the file paths or inline PEM contents.
3. Log In to Your REWE Account
npm run loginIn the opened Chrome window, open DevTools (
Cmd+Option+Ion macOS /F12on Windows/Linux) and switch to the Console tab first.Sign in with your REWE account (and 2FA if enabled).
Copy the
Failed to launch 'de.rewe.app://redirect?...'line from the Console and paste it into the terminal prompt.
4. Verify Setup
npm run statusChecks mTLS certificate configuration, OAuth session expiry, default market configuration, response cache settings, and performs a live check against the REWE Mobile Clients API.
Related MCP server: Rohlik MCP Server
Connecting to MCP Clients
Claude Desktop / Cursor / Antigravity (stdio)
{
"mcpServers": {
"rewe": {
"command": "node",
"args": ["/path/to/rewe-mcp/dist/index.js"],
"env": {
"REWE_MARKET_ID": "840174",
"REWE_ZIP_CODE": "50667",
"REWE_SERVICE_TYPE": "PICKUP"
}
}
}
}Streamable HTTP Server
npm run start:http -- --port 3000 --host 127.0.0.1Health check:
GET http://127.0.0.1:3000/healthzMCP endpoint:
POST / GET / DELETE http://127.0.0.1:3000/mcpOptional bearer protection: set
MCP_HTTP_AUTH_TOKEN=your-secret-token
Docker
docker build -t rewe-mcp .
docker run -d \
-p 3000:3000 \
-v ~/.config/rewe-mcp:/data \
-e MCP_HTTP_AUTH_TOKEN=your-secret-token \
rewe-mcpWhen /data exists, rewe-mcp automatically looks for /data/certs/certificate.pem, /data/certs/private.key, /data/tokens.json, and /data/store.json.
Available MCP Tools (30 Tools)
Account, mTLS & REWE Bonus
Tool | Description | Mode |
| Inspect OAuth session, mTLS cert status, and selected market | Read-only |
| Fetch REWE SSO userinfo, customer details, and REWE ID | Read-only |
| Fetch REWE Bonus euro balance, points overview, and article missions | Read-only |
| List available and activated REWE Bonus & app coupons | Read-only |
Markets & Default Store Configuration
Tool | Description | Mode |
| Search REWE stores by city, street, name, or PLZ | Read-only |
| Fetch market opening hours, address, phone, and services | Read-only |
| Check Pickup & Delivery availability for a PLZ | Read-only |
| Read active default | Read-only |
| Persist default market in | Stateful (idempotent) |
Discounts, Brochure & Product Catalog
Tool | Description | Mode |
| Fetch weekly market discounts (Angebote) grouped by category | Read-only |
| Filter weekly stationary offers by keyword | Read-only |
| Fetch digital weekly brochure (Prospekt) metadata | Read-only |
| Search live Pickup/Delivery assortment by keyword, EAN, or category | Read-only |
| Fetch full product details, ingredients, allergens, and nutrition | Read-only |
| Browse REWE online shop category tree for a market | Read-only |
| List active REWE safety product recalls (Produktrückrufe) | Read-only |
Recipes
Tool | Description | Mode |
| Search REWE recipes by keyword, difficulty, collection, or tags | Read-only |
| Fetch recipe ingredients, preparation steps, and nutrition | Read-only |
| Fetch popular recipe search terms | Read-only |
Digital Receipts (eBons) & Online Orders
Tool | Description | Mode |
| List in-store digital receipts (eBons) and Bonus earned | Read-only |
| Download eBon PDF receipt (base64 or save to | Stateful (idempotent) |
| List online Pickup/Delivery order history | Read-only |
| Fetch line items, prices, and timeslot for an online order | Read-only |
Favorites, Basket & Timeslots
Tool | Description | Mode |
| List saved REWE favorite lists and product listings | Read-only |
| Add or remove a product in a REWE favorite list | Stateful (idempotent) |
| Fetch or initialize active Pickup/Delivery basket | Stateful (idempotent) |
| Set absolute quantity for a | Stateful (idempotent) |
| List available Pickup/Delivery timeslots and fees | Read-only |
Grocery Trip Planning
Tool | Description | Mode |
| Analyze purchase frequency, cadence, and items due for restock | Read-only |
| Match regular products & shopping list against current offers/coupons | Read-only |
Environment Variables
Variable | Default | Description |
|
| PEM string or path to Cloudflare client cert |
|
| PEM string or path to Cloudflare client private key |
|
| OAuth token persistence file |
|
| Default market persistence file |
|
| Fallback default market ID ( |
|
| Fallback default German postal code |
|
| Fallback default service ( |
| None | Optional bootstrap refresh token |
| None | Optional static/ephemeral access token |
|
| Set to |
|
| Maximum cached responses in memory |
|
| Set to |
|
| Bind host in HTTP mode |
|
| Listen port in HTTP mode |
|
| HTTP MCP route path |
| None | Optional Bearer token required for HTTP MCP requests |
|
| Set to |
|
| Idle session expiry timeout (ms) |
Development
npm run build # Compile TypeScript -> dist/
npm test # Run offline test suite via node:test + tsxAll unit and integration tests run offline with mocked HTTP / mTLS fixtures. No REWE credentials or external network calls are required.
Disclaimer
This project is an unofficial, community-maintained Model Context Protocol (MCP) server. It is not affiliated with, endorsed by, or sponsored by REWE Markt GmbH or its subsidiaries. All trademarks and brand names belong to their respective owners.
License
MIT
Available Tools
30 toolsrewe_auth_statusCheck REWE OAuth & mTLS Certificate StatusARead-only
Inspect current REWE Keycloak SSO session status (token source, expiry, customerId), Cloudflare mTLS client certificate configuration, and active default market selection.
Inputs: no named parameters. Returns: message, savedAt, expiresAt, customerId, +11 more
rewe_get_basketGet Current REWE BasketAIdempotent
Fetch or initialize the active REWE Pickup or Delivery basket for the configured market and return items, totals, version, and minimum order threshold status.
Inputs: zipCode, basketId, marketId, serviceType. Returns: id, items, version, zipCode, +5 more
rewe_get_bonusGet REWE Bonus Balance & Loyalty OverviewARead-only
Fetch your REWE Bonus euro credit balance, loyalty points overview, tier status, and active article missions.
Inputs: no named parameters. Returns: statusTier, balanceCents, balanceEuros, loyaltyPoints, +1 more
rewe_get_brochureGet REWE Weekly Brochure / Prospekt MetadataBRead-only
Fetch digital stationary handout/brochure (Prospekt) metadata for a REWE market.
Inputs: marketId. Returns: handout, marketId
rewe_get_couponsGet REWE Bonus & App CouponsARead-only
Fetch available and activated REWE Bonus and personal digital app coupons.
Inputs: no named parameters. Returns: count, coupons
rewe_get_discountsGet Weekly REWE Store Discounts (Angebote)BRead-only
Fetch current weekly promotional offers/discounts for a REWE market grouped by category.
Inputs: limit, zipCode, marketId, categoryId. Returns: marketId, categories, handoutUrl, validUntil, +1 more
rewe_get_ebon_pdfDownload REWE eBon Receipt PDFAIdempotent
Download the original PDF receipt for a given ebonId. Optionally pass savePath to write the PDF directly to disk; otherwise returns base64Pdf and sizeBytes.
Inputs: ebonId (required), savePath. Returns: id, savedTo, base64Pdf, sizeBytes
rewe_get_favoritesGet REWE Favorite Product ListsARead-only
Fetch your saved REWE favorite lists along with product details, listingIds, and prices for the configured market.
Inputs: includeProducts. Returns: count, lists
rewe_get_market_detailsGet REWE Market DetailsARead-only
Fetch full details for a REWE market (wwIdent): opening hours, phone number, address, and in-store services.
Inputs: marketId. Returns: id, name, phone, wwIdent, +3 more
rewe_get_order_detailsGet REWE Online Order DetailsARead-only
Fetch full line-item breakdown, quantities, prices, and timeslot details for a REWE online order.
Inputs: orderId (required). Returns: id, items, status, createdAt, +1 more
rewe_get_product_detailsGet REWE Product Details & NutritionBRead-only
Fetch detailed product information including description, ingredients, allergens, nutrition table, GTIN, and listing price.
Inputs: productId (required), zipCode, marketId, serviceType. Returns: id, price, title, allergens, +2 more
rewe_get_product_recallsGet REWE Product RecallsARead-only
Fetch active REWE product safety recalls (Produktrückrufe).
Inputs: no named parameters. Returns: count, recalls
rewe_get_profileGet REWE Member ProfileARead-only
Fetch authenticated REWE SSO userinfo, customer profile, REWE ID, and configured store settings.
Inputs: no named parameters. Returns: sub, email, reweId, zipCode, +7 more
rewe_get_recipe_detailsGet REWE Recipe Ingredients & Preparation StepsARead-only
Fetch complete REWE recipe details by recipeId: portion yield, preparation/cooking times, structured ingredients list, step-by-step instructions, and nutrition values.
Inputs: recipeId (required). Returns: id, steps, title, ingredients
rewe_get_recipe_popular_termsGet Popular REWE Recipe Search TermsARead-only
Fetch trending/popular recipe search terms shown on the REWE recipes landing page.
Inputs: no named parameters. Returns: count, terms
rewe_get_selected_marketGet Configured Default REWE MarketARead-only
Show the currently active default REWE marketId (wwIdent), zipCode (PLZ), and serviceType (PICKUP or DELIVERY).
Inputs: no named parameters. Returns: city, zipCode, marketId, updatedAt, +2 more
rewe_get_service_portfolioCheck REWE Pickup & Delivery Availability for Zip CodeARead-only
Check whether REWE Lieferservice (delivery) and REWE Abholservice (pickup) are available for a German postal code (PLZ), and list matching market IDs.
Inputs: zipCode. Returns: zipCode, pickupMarkets, customerZipCode, deliveryMarketId, +1 more
rewe_get_shop_categoriesGet REWE Shop CategoriesARead-only
List top-level and nested REWE online shop categories (slug, product counts) available for a market and service type.
Inputs: zipCode, marketId, serviceType. Returns: count, categories
rewe_get_timeslotsGet Available REWE Pickup/Delivery TimeslotsARead-only
List available Abholservice (pickup) or Lieferservice (delivery) checkout timeslots and service fees for the current basket and market.
Inputs: zipCode, basketId, marketId, serviceType. Returns: count, timeslots
rewe_list_ebonsList REWE Digital Store Receipts (eBons)ARead-only
List in-store digital receipts (eBons) with timestamps, store address, total spend, and REWE Bonus earned.
Inputs: limit. Returns: receipts, ebonActive, totalCount
rewe_list_ordersList REWE Online OrdersARead-only
List REWE Abholservice (pickup) and Lieferservice (delivery) online order history.
Inputs: limit. Returns: count, orders
rewe_manage_favoriteAdd or Remove Product in REWE Favorites ListAIdempotent
Add a product (listingId, optional productId) to a REWE favorites list or remove an entry (itemId) from a favorites list.
Inputs: action (required), listId (required), itemId, quantity, +2 more. Returns: action, listId, result
rewe_plan_grocery_tripPlan REWE Grocery Trip with Current Offers & CouponsBRead-only
Cross-reference your regular REWE products and extra shopping list items against current weekly stationary discounts and REWE Bonus coupons.
Inputs: zipCode, marketId, maxOrders, extraItems, +2 more. Returns: note, zipCode, marketId, serviceType, +9 more
rewe_regular_productsAnalyze Regular REWE Products from Purchase HistoryBRead-only
Analyze previously purchased products and online order history to identify frequently bought groceries, average prices, purchase cadence, and items due for restock.
Inputs: limit, maxOrders, minPurchases. Returns: note, ebonsCount, minPurchases, ordersAnalyzed, +4 more
rewe_search_discountsSearch Weekly REWE Discounts by KeywordARead-only
Search current weekly stationary offers at the selected REWE market by product name, brand, or category keyword.
Inputs: query (required), limit, zipCode, marketId. Returns: query, offers, marketId, validUntil, +1 more
rewe_search_marketsSearch REWE SupermarketsARead-only
Search REWE stationary supermarkets by city, street, market name, or German postal code (PLZ).
Inputs: query (required). Returns: count, markets
rewe_search_productsSearch REWE Product CatalogARead-only
Search the live REWE supermarket assortment for a market and service type (PICKUP or DELIVERY) by product name, EAN barcode, or category slug.
Inputs: page, sort, query, filters, +5 more. Returns: page, marketId, products, totalPages, +4 more
rewe_search_recipesSearch REWE RecipesBRead-only
Search REWE recipe database by keyword, difficulty, collection, or tags.
Inputs: page, tags, sorting, collection, +3 more. Returns: recipes, totalCount
rewe_set_basket_itemSet Product Quantity in REWE BasketAIdempotent
Add a product listing to your REWE Pickup/Delivery basket or update its absolute quantity (set quantity: 0 to remove the item).
Inputs: quantity (required), listingId (required), version, zipCode, +3 more. Returns: id, items, version, zipCode, +5 more
rewe_set_selected_marketSet Default REWE Market & Service TypeAIdempotent
Persist the default REWE marketId (wwIdent), zipCode (PLZ), and serviceType (PICKUP or DELIVERY) in ~/.config/rewe-mcp/store.json for subsequent product, offer, and basket calls.
Inputs: marketId (required), city, zipCode, marketName, +1 more. Returns: city, zipCode, marketId, updatedAt, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 30 tools
Most tools target a clear resource+action pair (market details vs. market search, product search vs. product details, order list vs. order details, ebon list vs. ebon PDF). The main overlap is rewe_get_discounts vs. rewe_search_discounts (weekly offers, one grouped by category, one keyword-filtered), and the composite rewe_plan_grocery_trip partially overlaps rewe_regular_products and the discount tools, but descriptions make the distinction workable.
Nearly every tool follows a consistent rewe_<verb>_<noun> snake_case pattern with a stable prefix. Two deviations: rewe_regular_products omits a verb entirely, and rewe_manage_favorite uses a generic verb that covers both add and remove, which is slightly less predictable than the add_/remove_ convention used elsewhere.
At 30 tools the surface is heavy for a single MCP server, though the REWE domain genuinely spans auth, loyalty, markets, offers, products, recipes, receipts, orders, favorites, and basket. Many tools are narrow single-call wrappers (recipe popular terms, brochure metadata, service portfolio) that could have been consolidated, but each does earn a place.
Coverage is broad and coherent across the shopping lifecycle: auth/profile, loyalty and coupons, market selection, discovery, basket, timeslots, and historical orders/receipts. The notable gap is checkout — there is a basket and timeslot tool but no tool to place or cancel an order, and basket clearing only works implicitly via quantity 0.
Maintenance
Related MCP Connectors
Grocery lists, recipes, menu plan, household, supermarket offers and receipt photos to track costs
Shared grocery and shopping list with pantry and weekly supermarket deals in 15 countries.
Live prices, deals & optimal multi-stop shopping routes for German grocery & drug stores.
Turn any shopping list into a ready-to-checkout grocery cart across 26 European supermarkets.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI assistants to securely access a personal Dutch supermarket account, including digital receipts with itemized prices, discounts and VAT, loyalty points balance, and active shopping lists, plus search for nearby stores and products in the grocery catalog.20MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to search grocery products, manage shopping carts, access account and order information, and find deals and delivery details across several European online grocery platforms.-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to search grocery products, manage shopping carts, view discounts, and access account, delivery, and order information across multiple European online grocery platforms.-
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search grocery products, manage shopping carts, view orders and delivery information, and get personalized meal and deal suggestions across multiple European grocery delivery services.MIT