How SupperSecret works

SupperSecret plans your household's dinners from your own recipes, keeps one shopping list for everyone, and moves the week along when a night doesn't go to plan. This page covers everything, in the order you'll need it.

Getting started

Open your invite. SupperSecret is invite-only during the beta. Open the beta invite you were sent, or an invite from someone already in your household.
Sign in with your email or Google. There's no password.
Set up your household in three short steps: who eats here (with allergies and the nights they're home), a few things about your kitchen, and whether to start with sample dinners or your own recipes.
Put it on your phone and invite your family. Both are offered when setup finishes, and both live in the ☰ menu.

Put it on your phone

SupperSecret runs in your phone's browser and installs to your home screen, where it opens full screen like any other app.

Android (Chrome): open the ☰ menu and tap Install the app, or tap Install it on the banner on Today. Chrome asks once; tap Install.
iPhone and iPad (Safari): tap the Share button, scroll down, tap Add to Home Screen, then Add.
Opened inside Gmail, Instagram or another app? Those built-in browsers can't install anything. Open suppersecret.app in Chrome or Safari first.

Type your email and we send a sign-in link and a 6-digit code. Tap the link, or type the code. Both work once, for 10 minutes. Check spam the first time.
The link works even if it opens inside your email app's own browser, and it takes you back to the invite you started from.
Continue with Google works too, and finds the same account if your Google email matches.
Opened an invite meant for a different email than the one you're signed in with? SupperSecret says so and offers Sign in with a different email.
Sign out from the bottom of the ☰ menu.

Tonight: one question

Today shows tonight's dinner and who's eating. Afterwards, answer the one question: what happened?

Cooked it. Optionally say how many portions went in the fridge.
We got takeout, Ate leftovers, Everyone fended or Nobody ate here. Tonight's dinner moves to tomorrow, because its ingredients are still in the fridge, and the rest of the week shuffles along. Nothing is wasted and nothing needs catching up.

The week and the 28-day cycle

SupperSecret plans around a 28-day menu cycle, the way large kitchens like military dining halls plan theirs: four weeks of dinners that repeat and get better each time round. Weeks run Sunday to Saturday, and the next 28 days of dinners are always planned. See them under Week → Next 28 days.
Each week has five dinners and two open nights for takeout, leftovers or something from the pantry.
Set your big shop day on that screen. Dinners are ordered so what spoils first is cooked first after the shop, and the open nights fall at the end of the trip.
Rate dinners after you eat them. That's all the cycle needs from you. A dish someone in the house won't eat comes out. A couple of nights are kept for trying something new, and a new dish everyone rates 4 or 5 joins the cycle. The card at the top of Next 28 days says what changed and why.
Open a night to see its recipe, swap the dish, add a side, set it as a takeout or leftovers night, change who's eating, or add guests. Changing a night changes that night only, never the cycle.
A dish you put on a night yourself is pinned and stays put, however far ahead it is. Fill puts dinners on empty nights and touches nothing else. Redraft starts the week again from the cycle, so it asks first.

Adding recipes

Start with the handful of dinners you already make. The easiest way is Ask:

Paste a link to a recipe on a food site.
Photograph a recipe card or a cookbook page, front and back if you like. Handwritten notes and crossed-out ingredients count.
Paste or type the recipe.

It's read, put into your household's terms (whole packages, the names already in your pantry), and shown for you to check before it joins the library. Recipes can also be added and edited by hand on Recipes. If you started with sample dinners, they step aside as your own come in.

Making more or less. A recipe opened from tonight starts at the size of tonight's table, and the ½× to 3× buttons above the ingredients change it. When a recipe uses part of a package (half a box of pasta, two chicken breasts from a pack of four), it offers the size that uses the whole package, so there's nothing left half-open and less to measure. Recipes that don't say how many they serve stay as written.

Pantry and shopping list

Staples are measured one of two ways: gauges (flour, oil, spices: how full) or counts (cans, bananas, bags of peas). Each has its own point at which it goes on the list.
Things you grow or make yourself are tracked but never put on the list.
The shopping list builds itself from the week and whatever's running low, grouped by section of the store. Amounts are added up into what you'd buy ("2½ sticks" of butter, not five spoon measures), and what's already counted in the pantry comes off. Things every kitchen keeps by the spoonful, like salt and oil, gather in one Check you have row at the end.
Amounts follow who's eating each night. To shop for the recipes exactly as written instead, switch it at the bottom of the list.
Splitting the shopping: sort lines into shops first. Tap + Add a shop at the top of the list, name it, tap what comes from there, then Done. Then tap Split up the shopping and choose who's going to each shop and who gets everything else: "Seth takes Publix and Target, I'll get the rest" is two taps and Split it. Tap someone's name at the top to see just their part, and Send … their list to text it to them. Shops are remembered for each item next week; who's getting what is just for this trip. The ⋯ on any line changes one line at a time.
Print the week from the bottom of the Week tab. Everyone in the household sees the same list.
Back from the store? Tell the assistant, or finish the list, and what you ticked comes off and tops the pantry back up.
A photo of a shelf or freezer in Ask updates the pantry in one go.

Leftovers

☰ → Leftovers lists what's in the fridge, oldest first, and who each portion is put by for. Record what was eaten so the planner learns which dinners don't survive a night in the fridge. If your household keeps chickens, scraps past their date can go to them, and anything they mustn't eat is kept back and named.

Who eats here

☰ → Who eats here holds each person's allergies, what they never eat, dislikes, likes and usual nights at home.
Allergies take a dish out of the plan altogether, and recipes that contain one say so at the top.
Never eats is for a diet, faith or choice: vegetarian, vegan, no pork, no shellfish, dairy-free, gluten-free, or anything you type. It keeps dishes off the plan just like an allergy, but it's never called one.
Dislikes are picked around, and the dish still gets made.
Visitors (a grandparent, a friend of the kids) only count on the nights you put them on, and their allergies only rule out those nights.
Trips away take someone off the table for those nights, so portions and the list follow.
Extra guests on a night are a simple count for cooking and shopping.

Inviting someone to dinner

Open the night on Week. Under Guests, tap Invite someone over, add a note if you like ("6:30, bring nothing!"), and send the link. You can also ask the assistant to make one.
Your guest needs no account. They see the menu and what's in each dish, and reply with whether they're coming, how many, any allergies and what they don't eat.
A yes puts them on that night with their allergies and what they don't eat, so portions, the list and the warnings follow. Replies show under Guests on the night.

An invitation shows only that night and stops working the day after.

☰ → Sharing shows who can open your household. Invite someone by email, or get a link to text them. Everyone sees the same week, recipes and list.
Kids don't need accounts. Add them under Who eats here instead.
An account can be in more than one household, such as a child of separated parents with a home at each. ☰ → Switch household moves between them, and each keeps its own week and its own nights.
The person who started a household can remove someone; anyone else can leave.

The assistant

Ask, in the app, is an assistant that can do almost anything the app can: plan and swap nights, import recipes, update the pantry and list, record leftovers, invite a guest, and answer questions about your history. It can't delete dishes or people, or reset anything.

Tell it lasting things about your household ("we buy carrots loose", "we don't track snacks") and it remembers them in every conversation.
Each household has a monthly assistant allowance. When it runs out, the assistant pauses until the next month; everything else keeps working.

Using it from Claude, ChatGPT or Claude Code

If you already pay for an AI app, you can connect it to SupperSecret and use it as much as you like on that subscription, not your household's assistant allowance. It gets the same abilities as the built-in assistant, for the one household you choose, and the same limits.

The connector address is:

https://suppersecret.app/mcp

Claude (claude.ai or the app): Settings → Connectors → Add custom connector, paste the address, then Connect.
ChatGPT: Settings → Connectors (custom connectors need developer mode), create a connector with the address.
Claude Code: install the plugin:
claude plugin marketplace add suppersecret/mcp claude plugin install suppersecret@suppersecret
or add the connector directly with claude mcp add --transport http suppersecret https://suppersecret.app/mcp --scope user. Then run /mcp in a session and choose Authenticate.

Each one sends you to SupperSecret to sign in, choose the household, and tap Allow. Disconnect any time from ☰ → Connected AI apps. If you leave the household, its connections stop working at once.

Your data

Your household's recipes and plans are visible only to the people in it. We don't sell or share them, and there are no ads. See the Privacy Policy.
To get a copy of your recipes, open ☰ → Download your data. Download recipes gives you one page with every recipe that any browser can open and print; Download everything is a JSON file with recipes, ratings, people, pantry and preferences. Photos aren't included yet; email us and we'll send them.
To delete your account, email hello@suppersecret.com from the address you sign in with.

Still stuck, or have an idea?

In the app, open ☰ → Send feedback to tell us what went wrong or what you'd like to see. You can choose to include device details (browser, system, screen size and the like), and you'll see exactly what they are before you send. Or email hello@suppersecret.com. A person reads every message.