✓ Saved to your recipes
Shakshuka with feta
35 min · 4 servings · 9 ingredients
- 6 eggs
- 200 g feta
- 2 tins tomatoes
- 2 red peppers
- 1 onion
- 3 cloves garlic
- 2 tsp cumin
- 1 tsp smoked paprika
- A handful of parsley
Your week, your shopping list and your pantry follow. An unofficial MCP server, CLI and local API for your Samsung Food account.
Free and open source (MIT) · your login stays on your machine · not affiliated with Samsung
Plan dinners for the next seven days from my saved recipes. Use up the spinach first.
Assistant
I’ll look at your week, your pantry and your saved recipes.
Done. Six new dinners from your saved recipes, and Saturday keeps the pumpkin soup you had planned. The dal goes first because the spinach runs out on Friday. Lentils, basmati and coconut milk are already in your pantry, so 11 things went on the list.
Produce
Fish & meat
Dairy
Pasta & grains
Paste a link from a food blog or a recipe site. It lands in your Samsung Food library with ingredients and steps, ready to plan or shop. Then ask for more like it.
Some sites block automated visitors; those imports fail with a clear error instead of a half-empty recipe.
✓ Saved to your recipes
35 min · 4 servings · 9 ingredients
Say “chicken breast, freezer” and the expiry date is filled in from shelf-life data. Ask what needs using up, and dinner plans start there.
Chicken breast
2 days
Keeps 1–2 days · expires Fri, 20 Nov
9 months
Keeps 270 days · expires Sun, 15 Aug 2027
Where food can go in the fridge or the freezer, you pick the place. Nothing is guessed.
Later
What’s for dinner tonight?
meal_plan_getSpinach dal, about 30 minutes. You have everything except a lemon. Shall I add one to the list?
Yes please.
shopping_list_addDone, one lemon is on your list.
Agent
Import example-kitchen.com/recipes/shakshuka and plan it for Friday.
Saved “Shakshuka with feta” and put it on Friday’s dinner.
Chat · Agent mode
What in my pantry expires this week?
pantry_getCoconut milk is good until the 27th. Want a dinner that uses the spinach tomorrow?
$ sf plan --days 3 Meal plan 2026-11-19 to 2026-11-21 Thu 2026-11-19 – 640 kcal Dinner Spinach dal [0193f2a7c4e1] Fri 2026-11-20 – 585 kcal Dinner Lemon orzo with peas [0193f2a7c4e2] Sat 2026-11-21 – 410 kcal Dinner Pumpkin soup [0193e81b02d9] $ sf pantry add "chicken breast" --location freezer chicken breast → Freezer, expires 2027-08-15 [8c02e0]
$ sf serve --read-only $ curl -s -X POST http://127.0.0.1:8787/v1/tools/pantry_get \ -H "Authorization: Bearer $SF_KEY" -d '{"search":"spinach"}' { "ok": true, "data": { "items": [{ "name": "spinach", "location": "Fridge", "daysLeft": 2 }] … } }
OpenAPI 3.1 at /openapi.json, docs at /docs, MCP over HTTP at /mcp.
For developers: All 89 tools CLI reference HTTP API Other MCP clients How it works
Each of the 89 tools is labelled as read-only, write or destructive, so your AI client knows which calls only look and can ask you before anything in your account changes.
~/.samsung-food with owner-only permissions, and renews itself while you use it.--read-only drops every write tool.npx unofficial-samsung-food-mcp setup. It needs Node.js 20 or newer.No install at all: the hosted connector (closed beta). Full walkthrough
npx unofficial-samsung-food-mcp setup
Or add it by hand:
One command. --scope user makes it available in every project.
claude mcp add --scope user samsung-food -- \
npx -y unofficial-samsung-food-mcp
Settings → Developer → Edit Config. Restart Claude afterwards.
{
"mcpServers": {
"samsung-food": {
"command": "npx",
"args": ["-y", "unofficial-samsung-food-mcp"]
}
}
}
~/.cursor/mcp.json, or .cursor/mcp.json in a project.
{
"mcpServers": {
"samsung-food": {
"command": "npx",
"args": ["-y", "unofficial-samsung-food-mcp"]
}
}
}
Command palette: MCP: Open User Configuration, or .vscode/mcp.json. Note the key servers and the type.
{
"servers": {
"samsung-food": {
"type": "stdio",
"command": "npx",
"args": ["-y", "unofficial-samsung-food-mcp"]
}
}
}
After npm link in the checkout, sf is on your path.
sf whoami
sf plan --days 7
sf list recipe <recipeId>
sf pantry add "chicken breast" --location freezer
sf login again.This project is not affiliated with, endorsed by or supported by Samsung or Whisk. “Samsung Food” is a trademark of its owner.
It uses a private, undocumented API that can change or break at any time. Using it may violate Samsung Food’s Terms of Service and could get your account restricted. Write tools change real data, including shared lists and meal plans. Use it at your own risk. FAQ