Give your assistant your kitchen.
It stops asking what you have.
Updated 20 November 2026
Savera keeps the state of your kitchen: what is in the fridge, the freezer, the pantry and on the spice shelf, and how fresh that information is. Connect it to Claude and your assistant reads that state when you plan dinner or write a shopping list. It can also add what you bought and mark what you used up: it shows you what will change, and the list changes when you confirm.
Connect to Claude
- Create a Savera account at savera.kitchen and scan one zone with your phone. The freezer is a good first zone: one scan stays true for weeks.
- In Claude, open the connector settings and choose “Add custom connector”.
- Name it Savera and paste this address:https://api.savera.kitchen/mcp
- Press Connect, sign in with your Savera account and allow access.
- Ask your assistant: “What is in my kitchen?”
The address has no slash at the end. Sign-in is OAuth: there is no key to copy. The request to connect stays open for 10 minutes; if you take longer, press Connect again.
The connector is tested with Claude on the web. Other assistants that speak MCP with OAuth and register themselves may work; we have not tested them yet.
Or let your assistant walk you through it
Paste this into your assistant. It reads our instructions and tells you what to do on your side.
What your assistant can see and change
- The products recorded in your kitchen, by zone.
- Their estimated use-by dates and when each was added or last seen.
- Your shopping list.
- The email address of your Savera account.
What it can change, after you confirm:
- Add products you bought, for example from a photo of your receipt. Claude shows a card with each product, its zone and how long it keeps; you untick what you do not want.
- Mark products as finished, running low or still plenty, for example after cooking.
- Read and add to your shopping list, and tick it off. It is the food part of your Savera notepad; buying the food ticks it off on its own.
- Send you a one-time link to scan a zone with your phone, without signing in.
Changes need an active subscription or trial. Claude also asks your permission before a tool that changes data, unless you told it to always allow that tool.
What it cannot do:
- Delete anything. Finished products stay in the history for 30 days.
- Read your chat with Savera or your notes that are not on the shopping list.
- See diets, allergies or health information. Savera does not pass them on.
To disconnect, open Savera, go to Settings and find “Connected assistants”, or remove the connector in your assistant.
How fresh the state is
Nobody is asked to subtract what they eat. You add things and you scan zones; a full scan of a zone replaces its list. Between scans Savera does not pretend to know: every zone carries the time of its last full scan and a freshness state, and an item nobody has seen for a long time becomes unknown instead of disappearing.
| Zone | fresh | aging | stale | Item becomes unknown after |
|---|---|---|---|---|
Fridge (fridge) | up to 3 days | 4 to 7 days | more than 7 days | 30 days unseen |
Freezer (freezer) | up to 21 days | 22 to 60 days | more than 60 days | 60 days unseen |
Pantry (pantry) | up to 14 days | 15 to 45 days | more than 45 days | 45 days unseen |
Spices and oils (spices) | up to 90 days | 91 to 365 days | more than 365 days | 365 days unseen |
Days in the freshness columns count from the last full scan of the zone. An item also becomes unknown when its estimated use-by date passed more than a week ago and nobody has seen it since. These are starting values and may change: an assistant should rely on the freshness and status the connector returns, not on this table.
knowledge_percent sums it up in one number from 0 to 100: how much of the kitchen recent full scans cover. Each zone counts for a quarter. The same number is shown in the app as “Savera knows your kitchen”.
Quantities are in words (“half a bag”), never in grams, and are often missing. Use-by dates are estimates from typical shelf lives unless you typed a date.
Tools
| Tool | What it does | Returns |
|---|---|---|
get_kitchen_contextGet kitchen overview | Overview of the four zones: when each was last scanned in full, how fresh that scan is, how many items it holds, and the items closest to their use-by date. | knowledge_percent, zones (last_full_scan_at, freshness, items by status, scan link), zones_to_rescan, expiring_soon |
get_kitchen_itemsList kitchen items | Items filtered by zone, by status, by a list of product names, or by days until the use-by date. One call checks a whole shopping list. | items (zone, status, quantity in words, confidence, first and last seen, use-by estimate), matches_by_name |
create_scan_linkCreate scan link | A one-time link to scan one zone with a phone, without signing in. It works for 60 minutes. The person takes the photos, checks what Savera found and confirms; only then does the kitchen change. | url, zone, expires_at |
prepare_add_itemsPrepare bought items | Changes nothing. For bought products (a receipt photo or a list in the chat) it returns the zone each would go to, an estimated use-by date and the item on record it replaces. In Claude the person ticks the products and confirms in a card. | items (name, zone, quantity in words, use-by date and whether it is an estimate, item replaced), skipped, can_save |
add_itemsAdd items | Adds the confirmed products to their zones. Only adds: nothing already on record changes. | added (the new items) |
prepare_use_upPrepare used ingredients | Changes nothing. For ingredients used in cooking it finds the matching items and proposes finished, running low or still plenty. In Claude the person adjusts and confirms in a card. | items (item on record, the name asked, proposed status), not_on_record, can_save |
mark_itemsMark items | Marks items as finished, running low or still plenty. Finished items stay in the history for 30 days; nothing is deleted. | changed (the items with their new status), ignored_ids |
get_shopping_listGet shopping list | The household shopping list: the open food entries of the shared Savera notepad, each with the matching items already at home. Other notes are never shared. | entries (text, when added, whether an assistant added it, matching items at home) |
add_to_shopping_listAdd to shopping list | Adds products to the shared list. A product already on it is not added twice. Only adds. | added, already_on_list |
check_off_shopping_listCheck off shopping list | Ticks entries off as bought or removes them. Adding bought products to the kitchen ticks the matching entries off on its own. | bought, removed, ignored_ids |
Item statuses: have, low (seen nearly empty), out (finished, thrown away or not found by a full scan in the last 30 days) and unknown. Names are matched by whole words, ignoring case, accents and a plural s; they are not translated between languages.
Examples
Things people ask once Savera is connected, and what happens.
| You ask | The assistant calls | You get |
|---|---|---|
| “What can I cook tonight with what is in my fridge?” | get_kitchen_context, then get_kitchen_items with zone "fridge" | Dishes built from the items on record, the ones closest to their use-by date first. If the fridge was last scanned long ago, the assistant says so. |
| “Do we still have eggs and butter?” | get_kitchen_items with names ["eggs", "butter"] | One line per product: at home, running low, finished, or not on record, with the time it was last seen. |
| “What should I use up this week?” | get_kitchen_items with expiring_within_days 7 | The items whose estimated use-by date falls within seven days or has passed, with the days left. |
| “I want to make pancakes on Sunday. What do I need to buy?” | get_kitchen_items with the names of the ingredients | A shopping list of what is missing or running low; what is already at home is left out. |
| “My fridge list is old. Can I update it from here?” | create_scan_link with zone "fridge" | A link to open on the phone. The person photographs the fridge, checks the list Savera found and confirms it; the assistant reads the new state afterwards. |
| “(a photo of a supermarket receipt) Add this to my kitchen.” | prepare_add_items with the products read off the receipt, then add_items with the ones the person kept | A card with one row per product, its zone and how long it keeps. The person unticks what is not food and confirms; the products are added. |
| “We just made carbonara. Update the kitchen.” | prepare_use_up with the ingredients of the dish, then mark_items with what the person confirmed | A card with the matching items: eggs running low, bacon and parmesan finished. The person adjusts and saves. |
| “Put what I need for lasagne on the shopping list.” | get_kitchen_items with the ingredients, then add_to_shopping_list with the missing ones | Only what is not at home goes on the shared list; the household sees it in the Savera app, and it is ticked off when the receipt is added. |
| “How up to date is my kitchen list?” | get_kitchen_context, no arguments | The four zones with the time of their last full scan and a freshness state, knowledge_percent, and the zone worth scanning next. |
Savera cannot be changed from the assistant. Asked to add or remove something, it tells you to do it in the Savera app.
Skills
Three ready-made skill files for common kitchen questions. Each one reads Savera when it is connected and asks you what you have when it is not, so they are useful either way. To add one to Claude, download the ZIP, open Customize, then Skills, and upload it.
Is it at home?
Checks a shopping list, a recipe or one product against what is already at home, and sorts it into buy, already home and not sure.
Try: “Do we have soy sauce?” · “Check my list: rice, eggs, butter, lemons” · “What do I need to buy for this recipe?”
Forgotten in the freezer
Finds what has been sitting longest in the freezer or at the back of the pantry and proposes three dinners that use it up.
Try: “What should I use up from the freezer?” · “We leave on Friday, help me empty the freezer” · “Dinner ideas from stuff I forgot I had”
A week from what's home
Plans a week of dinners around what is already in the kitchen, perishables first, and lists only what is missing.
Try: “Plan our dinners for the week” · “Grocery list for the week, use what we have” · “5 dinners for 2, 30 minutes each”
Privacy
Photos you take for a scan are read by an AI model and are not stored: only the resulting list is kept. The list is kept in a database in the EU; requests pass through our servers in the United States. An assistant you connect receives what is listed above and nothing else, and only after you approve it. The full text, including a section on connected assistants, is in the privacy policy.
If something does not work
- Sign-in ends with an error. The request expired after 10 minutes. Press Connect again in your assistant.
- The assistant says the kitchen data is old. It is right. Scan the zone again in Savera; it takes a photo or two.
- An item is missing. Items are matched by name without translation. If your kitchen is recorded in another language, ask in that language or ask the assistant to list the zone.
- Anything else. Write to hello@savera.kitchen.