albertheijn-mcp

Your Albert Heijn shopping, from your AI assistant.

albertheijn-mcp is a small server that runs on your own computer. It lets Claude, ChatGPT, Cursor and other MCP clients search the Albert Heijn assortment, read this week's bonus, plan meal prep from recipes, and fill your basket once you have approved what goes in.

curl -fsSL https://danieltyukov.github.io/albertheijn-mcp/install.sh | sh
irm https://danieltyukov.github.io/albertheijn-mcp/install.ps1 | iex
npm install -g https://github.com/danieltyukov/albertheijn-mcp/releases/latest/download/albertheijn-mcp.tgz && albertheijn-mcp setup

Needs Node 20 or newer. Works with Claude Desktop, Claude Code, ChatGPT, Codex, Cursor, VS Code, Windsurf, Zed and Gemini CLI.

How it works
  1. InstallOne command installs the server and adds it to the MCP clients it finds on your computer.
  2. AskSearch products, check the bonus, find recipes or plan a week of meals. None of this needs an account.
  3. Sign in when you want your list and ordersRun albertheijn-mcp login. A browser window opens on Albert Heijn's own login page, you sign in as usual, and the window closes by itself.
Things you can ask
What it covers
Products
Search with bonus, brand, Nutri-Score, diet and allergy filters. Details with nutrition per 100 g, ingredients and allergens. Barcode lookup, and comparisons on price per kilo or protein per euro.
Bonus
This week's and next week's offers by section, every product in an offer, your personal Bonus Box, and basket totals with "2 voor" and "1 + 1 gratis" deals applied the way Albert Heijn applies them.
Recipes
Allerhande recipes by ingredient, diet or course, scaled to any number of servings, with Albert Heijn's product for each ingredient. Import recipes from other sites, or read any public web page for research.
Meal prep
plan_meal_prep merges several recipes into one list. It finds a product for each ingredient, works out packs and leftovers, skips what you already have, and prices it all with the bonus.
Your list and order
The shopping list and favourite lists, your booked order with its closing time, delivery slots with their prices, past orders and the products you buy most.
Receipts and stores
In-store receipts and a monthly spending summary. Nearby stores with opening hours, and marked-down items in a store.
Ordering, carefully

In the Albert Heijn app, your shopping list and your online order share one basket. Once you book a delivery, whatever is in that basket gets delivered and charged.

Privacy
Questions
Do I need an Albert Heijn account?

Not for products, bonus, recipes, stores, delivery slots for an address, or meal planning. You only need one for your list, orders, receipts and personal bonus.

Can it place an order on its own?

No. You book the delivery slot and pay in the Albert Heijn app. After that the assistant can fill the order, and every change to it needs your approval of a preview first.

Which browsers work for signing in?

Google Chrome, Microsoft Edge, Chromium or Brave. Without any of them, albertheijn-mcp browser install downloads Chromium, or albertheijn-mcp login --manual lets you sign in in any browser and paste the result back.

Does it understand English recipes?

Yes. Quantities and units are read in Dutch and English. Product names on Albert Heijn are Dutch, so the assistant passes Dutch search terms for English ingredients.

How do I connect ChatGPT?

Run albertheijn-mcp serve --http --tunnel and paste the URL it prints into ChatGPT's connector settings.

Is this official?

No. It is an independent open source project, not made or supported by Albert Heijn. It uses the same undocumented API as the Albert Heijn app, which can change without notice.