Skip to content
MCP server

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.0

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Fast Food Index

    MCP server

    Live US fast food menu prices, Big Mac index by state and verified price changes

    • 6 tools
    • Remote
    • Free
    • Food and drink
  5. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  6. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce