MealieShopper
Install

For anyone who cooks with Mealie

From recipe to sorted.

MealieShopper reads your week menu from Mealie, looks up every ingredient at Albert Heijn, Picnic, Jumbo or Crisp and, once you have checked it, puts the groceries in your basket. You place the order yourself.

Install View on GitHub
  • Free and open source
  • Runs on your own server
  • No account, no tracking
  • Dutch and English
MealieShopper on a computer and a phone: the week menu with pictures from Mealie, the servings per meal and Add on every day Enlarge the image The week menu in the dark theme, on a computer and a phone Enlarge the image
  • Albert Heijn
  • Picnic
  • Jumbo
  • Crisp
  • Mealie
  • HelloFresh
  • Marley Spoon

MealieShopper is unofficial and has no ties to Mealie or these stores.

How it works

Plan, check, done

Planning a week menu in Mealie is nice, but then the retyping starts: looking up every ingredient at your supermarket, working out how many packs you need and checking whether the offer really is cheaper. MealieShopper does that for you.

  1. Plan your week

    Put a recipe or a note on a day, in Mealie or in MealieShopper. Not sure? Then Surprise me picks a recipe. Every change is in Mealie straight away.

  2. One button for your groceries

    MealieShopper looks up the best products at your store for every ingredient, turns servings into packs and adds up the same ingredient from different recipes.

  3. You check, you order

    You first see a list with the price per kilo, and wherever the app has doubts there is a marker. Only after you confirm does everything go into your basket. An order is never placed.

Features

Everything between recipe and receipt

Your week menu, your supermarkets and your recipes in one place, for your whole household.

Week menu to basket

Your whole week in your basket in one go

One button looks up the best products for every ingredient in your week menu. You check everything in a list before it goes into your basket.

  • Servings and packs worked out
  • The same ingredient from several recipes added up
  • If another pack is cheaper per kilo, you see it straight away
  • With Prefer organic, the organic product first, if the store has it
Check your basket: per ingredient a photo of the product, the product with its price per kilo and the number of packs; for spaghetti it says 1 kg is cheaper per kilo, with the Choose button, and one line is marked Enlarge the image

Week menu planning

Plan your meals the way you want

Put a recipe or a note on a day, or move and remove a meal. Everything goes to Mealie straight away.

  • Your recipes from Mealie, with pictures and servings
  • Surprise me lets Mealie pick a recipe
  • Plan next week and you also see next week's offers
Plan a meal: the day, the meal, the choice between Recipe and Note, your recipes from Mealie and the Surprise me button Enlarge the image

Offers

Is it really a deal?

The offers of Albert Heijn (including your personal Bonus Box), Picnic, Jumbo and Crisp, updated every day and with an honest verdict.

  • The price per kilo, litre or piece for every offer
  • A verdict against the regular price of the last 30 days
  • The Price history also shows what you paid yourself
  • Compare pack sizes points out the cheapest
The Offers tab: the categories and the products with their deal, the price per kilo or litre, a coloured discount badge, a price label such as Lowest price ever and the links Compare pack sizes and Price history Enlarge the image

Recipes

Search everywhere at once, plan with one click

Search your own recipes in Mealie and, at the same time, Albert Heijn, Jumbo, Picnic and Crisp and the menus of HelloFresh and Marley Spoon.

  • View a recipe and plan it straight away
  • Import a recipe from a link
  • Put your saved AH recipes and Jumbo recipe lists into Mealie in one go
Searching recipes for kip: your own recipes in Mealie first, as cards with time, servings and tags Enlarge the image

Your stores

Your stores in one place

Your basket, lists, saved recipes, favourites, orders and AH receipts, kept as a copy of their own that you can search. Even when the store is unavailable.

  • When did you last buy coffee? Look it up
  • A receipt line the app does not know, you link to a product yourself
  • Your purchases per category, with what you saved
The purchases as cards: per order or receipt a collage of four product photos, the date, the kind with a coloured stripe, the number of products, the amount and the bonus amount saved Enlarge the image

AI assistants

Ask your AI assistant

With the built-in MCP server, Claude, ChatGPT or Copilot can look at your week menu, recipes and lists, plan a meal or import a recipe into Mealie.

  • OAuth login, with your own account
  • The assistant only works with your rights
  • The administrator turns the MCP server on or off
Profile, AI apps: the address of the MCP server and instructions per assistant Enlarge the image

And more

Made for every day

  • For the whole household

    Invite housemates with a link. Only the administrator links Mealie and the stores.

  • Safe sign-in

    With a passkey, or with a password and two-step verification.

  • An app on your phone

    Install MealieShopper as an app, with a menu bar like your other apps on an iPhone or Android device.

  • Your colours

    A light or dark theme and your own accent colour, for every user separately.

  • Dutch and English

    Everyone picks their own language, and every screen has its own address.

  • Backup in one file

    Make a backup with one click and restore it on a new server. You encrypt your links with a password of your own.

Screens

What it looks like

Every image shows the same screen on a computer and on a phone, with demo data.

  • The Price history of minced beef: key figures, a chart with the offers as bars, the regular price as steps and your purchases as dots, and the table of offers
    Price history: the offers, the regular price and what you paid yourself
  • Compare pack sizes for minced beef: the filters, at the top that 1000 g is €1.00 cheaper per kilo, and the packs with their price per kilo from cheap to expensive
    Compare pack sizes: the cheapest per kilo at the top
  • The Picnic basket with plus and minus buttons, the amount to pay and the delivery slots
    The Picnic basket, with the delivery slots
  • Search results at HelloFresh and Marley Spoon for the word kip, with cards and the View and Plan buttons
    Recipes from HelloFresh and Marley Spoon, planned with one click
  • My saved recipes with the group Doordeweeks chosen: two cards ticked, the buttons Select and Import whole group (4), and at the bottom the bar with Select all, Done and Import 2 recipes into Mealie
    Your saved AH recipes into Mealie in one go
  • The same receipt as cards: a card per line in the colour of its category, with the name and the photo of the webshop product, the discount, how often you bought it before and the bonus
    A receipt as cards, in the colour of each category
  • Settings, Appearance in the dark theme: the Dark grey background is chosen, and under Accent colour ten circles and Custom colour, with Blue chosen
    Appearance: a dark theme and your own accent colour
  • Settings, Appearance, Navigation bar: Automatic, iOS-like and Android-like, with Android-like chosen; on the phone the bar at the bottom spans the full width with a pill behind More
    The menu bar as on an iPhone or an Android device
  • Setup guide, step 1: choosing security
    The setup assistant on the first start
  • Profile, Security: password, two-step verification and passkeys
    Passkeys, a password and two-step verification
  • Settings, Users: the administrator with two users, and a form to invite someone
    Inviting housemates with a link

Privacy

You stay in control

MealieShopper runs in your own container. There is no account with us, and nothing is sent to us.

  • No analytics, no tracking

    The update check only asks GitHub for the latest version, without sending anything about you or your installation.

  • Everything in one folder

    Your data sits in a database on your own server. Include that folder in your backups and you have it all.

  • Encrypted links

    Your links with Mealie and the stores are stored encrypted. The app keeps neither store passwords nor your delivery address.

  • AI only when you want it

    Something only goes to an AI service when the administrator enters a key of their own and presses the button themselves.

Install

Up and running in a few minutes

You need an Unraid server, a computer or NAS with Docker, or Home Assistant. There is nothing to set up beforehand: on the first start a setup assistant walks you through security and the links.

Unraid, from the app store

  1. In Unraid, open the Apps tab (Community Applications) and search for MealieShopper.

  2. Choose Install, then Apply. The port (5959) and the folder for your data (/mnt/user/appdata/mealieshopper) are already filled in; everything else is optional.

  3. Open the web interface from the MealieShopper icon on the Docker tab and follow the setup assistant.

MealieShopper is in Helmer's Repository. Want new features earlier? Then also install MealieShopper (beta): it runs next to the stable version, with a folder of its own and port 5960.

Docker Compose

  1. Create a folder for your data and fetch the compose file.

    Terminal
    mkdir -p /mnt/user/appdata/mealieshopper
curl -fsSLO https://raw.githubusercontent.com/helmerzNL/MealieShopper/main/docker-compose.yml

  2. Start the container.

    Terminal
    docker compose up -d

  3. Open http://<your-server-address>:5959 and follow the setup assistant.

The compose file keeps your data in /mnt/user/appdata/mealieshopper. If you use another folder, change the path under volumes.

Docker

  1. Start the container, with a folder for your data.

    Terminal
    docker run -d --name mealieshopper -p 8000:8000 \
  -v /mnt/user/appdata/mealieshopper:/data \
  ghcr.io/helmerznl/mealieshopper:latest

  2. Open http://localhost:8000 and follow the setup assistant.

The image is built for linux/amd64 and linux/arm64. The beta tag gets new features earlier; use a folder of its own for it.

Home Assistant add-on

  1. Go to Settings, Add-ons, Add-on store, open the menu at the top right and choose Repositories.

  2. Add this repository and install MealieShopper.

    Repository
    https://github.com/helmerznl/mealieshopper

  3. Click Start and open http://<home-assistant-address>:5959. The setup assistant does the rest.

For Home Assistant OS and Supervised. Home Assistant includes your data in its own backups.

What you need

  • Your own Mealie, with an API token
  • An account at Albert Heijn, Picnic, Jumbo or Crisp
  • Docker on amd64 or arm64: a Raspberry Pi or an ARM NAS works too
  • For passkeys and installing as an app: a domain name with HTTPS
Read the manual All settings

Do the first start on a network you trust. As long as no sign-in method is set up, whoever opens the address first can claim the installation.

Questions

Frequently asked questions

What does MealieShopper cost?

Nothing. MealieShopper is open source under the MIT licence and runs on your own server. If you want to support its development, you can with a coffee.

Do I need Mealie?

Yes. MealieShopper is made for anyone who keeps their recipes in Mealie. Your week menu and the recipes you import live in your own Mealie; MealieShopper links to it with an API token. Mealie itself is free and self-hostable too.

Does MealieShopper order my groceries?

No. MealieShopper puts products in your basket after you have checked the list. You complete the order yourself, at Albert Heijn, in the Picnic app, at Jumbo or in the Crisp app. An order is never placed.

Which supermarkets does it work with?

Albert Heijn, Picnic, Jumbo and Crisp. Picnic also works with an account from Germany or France. You can also search recipes at HelloFresh and Marley Spoon.

At Picnic and Crisp you can change the basket in MealieShopper too; the Jumbo basket you can only view there.

Is this an official app of the supermarkets?

No. MealieShopper is an unofficial tool and has no ties to Mealie, Albert Heijn, Picnic, Jumbo or Crisp. It uses the stores' unofficial app APIs, which can change without notice. It is meant for personal use.

Where is my data kept?

In one folder on your own server: /data in the container, with an SQLite database and a key file. Include that folder in your backups. In the app you can also make a backup file with one click and restore it on another server.

Does it run on a Raspberry Pi or a NAS?

Yes. The image is built for linux/amd64 and linux/arm64, so it also runs on a Raspberry Pi and on an ARM NAS, such as some Synology models. On Unraid you install it from the app store (Community Applications), in Home Assistant as an add-on.

Can I use it on my phone?

Yes. Open the address of your installation and install MealieShopper as an app: on an iPhone with Share, Add to Home Screen, on Android in Chrome with Install app. Installing works over HTTPS.

What is the difference between stable and beta?

The latest tag is the stable version. The beta tag gets new features earlier and shows a beta badge next to the logo. If you run beta, use a folder of its own for your data.

Free, and it stays that way

Is it useful to you? A coffee keeps the development going. A star on GitHub or a reported bug helps too.

Buy me a coffee Support on Ko-fi Star it on GitHub