Albert Heijn

What Albert Heijn MCP server does

The Albert Heijn MCP server exposes an Albert Heijn account through MCP tools for grocery planning and ordering workflows. It can search products using one or more keywords, inspect product details and nutrition, find suggested alternatives, and filter results by bonus status, dietary labels, allergens or other supported filters. Dutch search terms generally produce the best results.

The server also covers Allerhande recipes. An assistant can search recipes, retrieve ingredients, preparation steps and nutrition per serving, then scale the ingredient quantities for a different number of servings. Recipe ingredients can be matched to Albert Heijn products and added to a shopping list in one operation. The matching process can prefer products currently on bonus, skip items the user already has, or run as a preview with no changes.

For the shopping workflow, tools read and modify the active shopping list, add free-text items, manage favourite lists, inspect the active cart, change quantities and remove products. Delivery tools show available time windows, while order tools list upcoming or previous orders and retrieve the products in a selected order. Store search and Vandaag-af markdown lookup support local shopping decisions.

How it works

The Albert Heijn MCP server communicates with an AI client through the Model Context Protocol. Local clients start it with npx -y albert-heijn-mcp, or users can install the package globally and run its command. Claude Desktop can install the published MCP bundle, while Cursor and VS Code provide installation links in the project documentation.

Authentication begins through the ah_login tool. On a computer with a supported browser and display, the server opens a separate Albert Heijn login window. If that is not possible, it returns a login link and completes authentication after the user supplies a code. ah_logout removes stored tokens so another account can be used or the session can be reset.

Setup and configuration

An Albert Heijn account is required. Local use requires Node.js 24 LTS and an MCP client that can launch a command. A typical client configuration uses the npx command with albert-heijn-mcp as its package argument. The package can also be installed globally with npm.

For ChatGPT or Claude.ai, the server must run on an internet-accessible host because those web and mobile clients cannot start a local process. The hosted MCP endpoint is added as a connector. The documented hosted login flow uses AH_MCP_TOKEN, entered once on the server's login page.

After installation, ask the connected assistant to log in. Local browser authentication requires Chrome, Edge, Brave or Chromium and a screen; otherwise the manual code-based flow can be used from a desktop browser.

Tools and capabilities

• Search products, inspect nutrition, find alternatives and filter by bonus or dietary criteria.
• Retrieve current or upcoming bonus offers, including products from grouped promotions.
• Search stores by postal code or address and find nearby Vandaag-af markdown items.
• Search Allerhande recipes, scale servings and add matched ingredients to a list.
• Read and edit the shopping list, free-text items, favourite lists and active cart.
• Check delivery slots, upcoming or past orders, and individual order contents.
• Read the member profile with name, masked email and the final four bonus-card digits.

Limitations and notes

The Albert Heijn MCP server is unofficial and is not affiliated with or endorsed by Albert Heijn. It uses the same API as the Albert Heijn mobile application, so API behaviour may change without notice. Product and recipe searches work best with Dutch terms.

Destructive operations require an explicit confirmation value: clearing the shopping list, deleting a favourite list and clearing the cart require confirm="yes". The login browser uses a fresh profile, so saved passwords and password-manager extensions are unavailable in that window. The server belongs in the E-Commerce category and should be treated as an account-connected shopping tool rather than an independent product database.