Albert Heijn
Unofficial MCP server for Albert Heijn Belgium: products, bonus offers and recipes
- Pricing
- Open source
- Platforms
- macOS, Windows, Linux
- Runs
- Locally or Remotely
- Version
- 1.2.0
- Listing updated
- 1 day ago
About Albert Heijn
Albert Heijn is an open-source MCP server for food and drink. It can run locally on your machine or as a hosted remote server.
This variant is a fork of an Albert Heijn server for the Dutch site, adapted for ah.be. Run with the --anonymous flag it needs no account and offers seven read-only tools for products, this week's bonus offers, bonus groups, product alternatives and recipes. Nothing in that mode touches a login, a shopping list or an order. The README says a Belgian login is not part of this version.
The README that follows describes the upstream Dutch version, where a logged-in account can manage a shopping list, upcoming deliveries and favourites lists, check delivery slots, and review in-store receipts. It also notes it uses the same API as the Albert Heijn mobile app, which may change without notice.
It can run as a Claude Desktop .mcpb bundle, a Docker image serving Streamable HTTP on port 3000, or through npx with a GitHub package token. The container has no caller authentication, so it should sit behind a gateway on a private network. The project is not affiliated with Albert Heijn or Ahold Delhaize.
Install
Run in a terminal
claude mcp add albert-heijn-be-mcp -- docker run -i --rm ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0Add to claude_desktop_config.json
{
"mcpServers": {
"albert-heijn-be-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"albert-heijn-be-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"albert-heijn-be-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"albert-heijn-be-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"albert-heijn-be-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- ah_search_products
- Searches products; named in the README's LiteLLM example.
What it does
- Anonymous mode
- Runs without an account using read-only tools.
- Bonus offers
- Looks up this week's bonus deals and groups.
- Product search
- Finds products and alternatives.
- Recipe lookup
- Searches recipes from the retailer.
- Desktop bundle
- Installs in Claude Desktop with a double-click .mcpb file.
- Docker image
- Serves Streamable HTTP for LiteLLM or other gateways.
Good for
- Find which products are on bonus this week at ah.be
- Look for a substitute when a product is sold out
- Plan weeknight meals around current offers
- Search products by diet or ingredient from an assistant
Pricing
Open source
Free, self-hosted
Albert Heijn FAQ
Is it official?
No. It is unofficial and not affiliated with Albert Heijn or Ahold Delhaize.
Do I need an account?
Not in anonymous mode, which is what this Belgian version offers.
How do I run it?
Install the .mcpb in Claude Desktop, run the Docker image, or use npx with --anonymous and Node.js 24.
Is the HTTP server secured?
No. The README says nothing authenticates a caller, so expose it only on a private network behind a gateway.
Is Albert Heijn free?
Yes. Albert Heijn is open source, so you can use and self-host it for free.
How do I add Albert Heijn to Claude Code?
Run this command in your terminal: claude mcp add albert-heijn-be-mcp -- docker run -i --rm ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0
What are the best alternatives to Albert Heijn?
The closest alternatives to Albert Heijn are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Fast Food Index and Renta.
Alternatives to Albert Heijn
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce

Fast Food Index
MCP serverLive US fast food menu prices, Big Mac index by state and verified price changes
- 6 tools
- Remote
- Free
- Food and drink

Renta
MCP serverRemote MCP server for running an outdoor rental shop on Renta from an AI client
- Remote
- Paid
- E-commerce

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce