lidl-mcp
Provides tools for interacting with Lidl and Lidl Plus across the Netherlands and Germany, including store search and opening hours, weekly digital leaflets and brochures, coupons and Coupon Plus, digital receipts, loyalty program details, and online shop product lookup.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
lidl-mcp
Model Context Protocol (MCP) server for Lidl (Lidl Plus) with built-in multi-country support (nl & de in a single server). Connects AI assistants (like Claude Desktop, Cursor, and Continue) directly to Lidl’s supermarket services.
Features include store search & opening hours, weekly digital leaflets & PDF brochures, Lidl Plus coupons & Coupon Plus, digital receipts (kassabonnen / Kassenbons), loyalty summary & stampcards, and online shop product lookup.
⚡ Quick Start
1. Install Dependencies
npm install2. Log In (Optional for Public Offers & Stores)
Public endpoints (stores, weekly leaflets, brochures, anonymous promotions) work without logging in. To access your personal coupons, receipts, loyalty card, and favorite store:
npm run loginLaunches Chrome via Playwright stealth to
accounts.lidl.com(PKCE OAuth2) and captures thecom.lidlplus.app://callbackredirect automatically.Headless/manual fallback:
npm run login -- --manual(or--country=de).
3. Check Status
npm run status4. Build & Test
npm run build
npm testRelated MCP server: Rohlik MCP Server
🌍 Multi-Country Support (nl & de)
A single lidl-mcp server supports both Netherlands (nl) and Germany (de) simultaneously:
Default country comes from
LIDL_COUNTRY(defaults tonl).Pass
country: "nl"orcountry: "de"on any country-aware tool to query across borders in the same session (e.g. comparing NL vs. DE weekly offers or checking receipts in both countries).Response cache keys are scoped by host, country, language, and auth principal so
nlandderesponses never collide.
🛠️ MCP Tools (25 Tools)
1. Authentication, Profile & Loyalty
Tool | Type | Description |
| Auth / Session | Check authentication status, refresh expired access token if available, and fetch member identity. |
| Read | Get Lidl Accounts OIDC profile & loyalty card details ( |
| Read | Get loyalty program status, active stampcards, and bottle deposits. |
| Read | Report process-scoped in-memory cache statistics ( |
2. Stores & Opening Hours
Tool | Type | Description |
| Read | Search NL or DE stores by city, postal code, address, |
| Read | Get store zone, offer region, amenities, and opening hours for a date. |
| Read | Get the user's favorite Lidl store ( |
| Write | Set the user's favorite Lidl store ( |
3. Offers, Digital Leaflets, Brochures & Shop Products
Tool | Type | Description |
| Read | List active flyers/brochures with web view URLs and PDF downloads. |
| Read | List active weekly digital leaflet campaign groups and campaigns. |
| Read | Fetch all products and prices inside a digital leaflet campaign. |
| Read | Search across active weekly digital leaflet campaigns by keyword. |
| Read | Get full details, pricing, and disclaimers for a leaflet product ID. |
| Read | Fetch online shop product details by ERP number ( |
4. Coupons & Promotions
Tool | Type | Description |
| Read | List Lidl Plus coupons (falls back to anonymous promotions when logged out). |
| Read | Get detailed terms and validity for a coupon/promotion UUID. |
| Write | Activate a Lidl Plus coupon for checkout. |
| Write | Deactivate an activated Lidl Plus coupon. |
| Read | Get Coupon Plus spend goals and progress. |
5. Digital Receipts (Kassabonnen / Kassenbons)
Tool | Type | Description |
| Read | List digital receipts ( |
| Read | Get itemized receipt lines, prices, discounts, and store info (cached 30d). |
| Read | Get receipt summary breakdown (cached 30d). |
| Write | Favorite or unfavorite a digital receipt. |
6. Grocery Trip Planning & Purchase History (Per Country)
Tool | Type | Description |
| Read | Analyze past receipts for one country ( |
| Read | Match regular purchases and optional extra items in one country against weekly leaflet offers and coupons. |
⚙️ Environment Variables
Variable | Description |
| Default 2-letter country code ( |
| Optional language override ( |
| Override path to |
| Bootstrap refresh token when no token file exists yet. |
| Optional HTTP endpoint for external token persistence. |
| Optional |
| Set to |
| Maximum cached entries (default: |
| Set to |
📄 License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Live prices, deals & optimal multi-stop shopping routes for German grocery & drug stores.
Live Dutch supermarket prices and promotions (Albert Heijn, Jumbo, Lidl, Aldi and more) for AI.
Persistent shopping memory for AI assistants. The AI reasons; Kaufliste stores and executes.
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.-
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search grocery products, manage shopping carts, and access account, order, delivery, and discount information across multiple European online grocery platforms.MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to connect to Albert Heijn supermarket services for product search, Bonus promotions, shopping lists, digital receipts, Allerhande recipes, store lookup, and profile/cart access while keeping checkout human-controlled.271MIT