# Albert Heijn

> Albert Heijn is an open-source MCP server for food and drink. Unofficial MCP server for Albert Heijn Belgium: products, bonus offers and recipes. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, self-hosted, CLI
- **Repository:** https://github.com/arnouthoebreckx/albert-heijn-be-mcp
- **MCP Registry name:** io.github.arnouthoebreckx/albert-heijn-be-mcp
- **Categories:** food and drink, e-commerce
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add albert-heijn-be-mcp -- docker run -i --rm ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "albert-heijn-be-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "albert-heijn-be-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "albert-heijn-be-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "albert-heijn-be-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "albert-heijn-be-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/arnouthoebreckx/albert-heijn-be-mcp:1.2.0"
      ]
    }
  }
}
```

## Tools

- `ah_search_products`: Searches products; named in the README's LiteLLM example.

## 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

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Fast Food Index](https://ai-powered.com/mcp/fast-food-index): Fast Food Index is a free MCP server for food and drink.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/albert-heijn-2
