A free, open-source meal planner for your household

What's open source here

The code for the Bot My Meals household app is public at github.com/timdoes/bot-my-meals under the MIT license. That means you can use, copy, change, and share it, as long as you keep the license notice with it. The software comes as is, with no warranty.

You make your own copy of the code, and the app runs in your own accounts. Your household's data lives there too, not with us. Each household can only see its own data.

Bot My Meals works for just you, a couple, roommates, or a family. Everyone opens the same app on their own phone, tablet, or computer and sees the same week and the same shopping list. It works in any web browser, and you can add it to your home screen or install it from the browser.

What you need

• A free GitHub account, for your own copy of the code
• A free Cloudflare account, which runs your app
• A free Supabase account, which stores your household's data
• Our bot, which is free to add. Add it from the setup page and it walks you through each step and tells you what to click next.

Plan on about an hour, one step at a time. Running it yourself costs nothing: the app runs on free Cloudflare and Supabase accounts, and our bot is free to add. When you're done, you get a link to your own app.

How shared approval works

1. Invite your household. Share an invite link. Each person opens it in any browser, on any device, and creates their own account with their own email and password. There is no shared household password and no code to type.
2. The bot plans seven dinners. Ask for a new week and the bot proposes dinners from your household's preferences and past weeks. Add allergies and foods to skip, and every dinner is planned around them. You can turn off nights you won't cook.
3. Swap or remove what you don't want. Anyone who votes can swap or remove a night, and a swap can include a short note like "too heavy" or "want tacos." Everyone sees changes as they happen.
4. The week locks. Just you? Approve on your own. Sharing? Everyone approves before the week locks. Leaving a dinner as it is keeps it, and once no swaps are left open, the week locks.
5. Cook and shop. After the week locks, you get full recipes for every night and one shopping list for the week, split by the stores you picked.

People in the house can be Users or Admins. Users can swap or remove a night. Admins can also manage people, stores, and how many people eat each night, and they can unlock the week.

Once your first week is going, you can cook this week and plan next week at the same time.

What it doesn't do

• It never invents grocery prices. The list shows what to buy and where.
• It doesn't come with a Docker setup or need a home server. It runs on Cloudflare Workers, with your data in Supabase, both in your own free accounts.
• It isn't a recipe site. It plans dinners for your household, and your household's meals stay in your own app.

How it compares to other self-hosted planners

There are several self-hosted options, and they solve different problems. Here is what each project says about itself on its own site or GitHub repo, as of October 19, 2026. Where a project doesn't say, the table says "Not stated."

Bot My Meals is built around one weekly loop: the bot plans, the household swaps and approves, the week locks, then recipes and a store-split list arrive. Mealie is a recipe manager and meal planner that can import recipes from the web. Several other projects also let the family vote or choose together.

Rather not host it?

We can host it for you at yourname.botmymeals.com, with no GitHub, Cloudflare, or Supabase to set up. It's 7 days free, then $9.99/mo or $99/yr, plus tax where it applies. One plan covers everyone at home. Try hosted free for 7 days.

Want to see it first? See a sample week. Planning for a family? Read about our AI meal planner for families.