Skip to content

Tell your assistant what you feel like eating.

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

Dinner planning samsung-food

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.

  • meal_plan_get (read-only)
  • pantry_get (read-only)
  • recipe_search (read-only)
  • meal_plan_add ×6 (write)
  • shopping_list_add 11 items (write)

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.

Reply…

Meal plan

Dinner · 19–25 Nov
  1. Thu19Spinach dal30 min · uses the spinach
  2. Fri20Lemon orzo with peas20 min
  3. Sat21Pumpkin soupplanned earlier
  4. Sun22Roast chicken thighs50 min
  5. Mon23Miso salmon with greens25 min
  6. Tue24Black bean tacos20 min
  7. Wed25Mushroom risotto40 min
Like this week? Save it as a template and reuse it any week.

Groceries

11 new

Produce

  • 2 lemons
  • 400 g mushrooms
  • 1 kg potatoes
  • 2 limes
  • Coriander

Fish & meat

  • 6 chicken thighs
  • 2 salmon fillets

Dairy

  • Parmesan
  • Sour cream

Pasta & grains

  • 300 g orzo
  • 300 g arborio rice
Sample conversation with sample data. Connected, it works on your own account.

Recipes from anywhere.

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.

https://example-kitchen.com/recipes/shakshuka Import
recipe_import_url

✓ 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
recipe_similar More like this
  • Green shakshuka
  • Menemen
  • Baked eggs with white beans

The pantry knows when things expire.

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

Storage location

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.

  • Crème fraîcheFridge · expired yesterday
  • SpinachFridge · 2 days left
  • Coconut milkFridge · 27 Nov
  • Greek yogurtFridge · 1 Dec

Later

  • Red lentils PantryApr 2027
  • Basmati rice PantryMay 2027
  • Chicken thighs FreezerAug 2027

Works where you already are.

Choose where you use it

What’s for dinner tonight?

meal_plan_get

Spinach dal, about 30 minutes. You have everything except a lemon. Shall I add one to the list?

Yes please.

shopping_list_add

Done, one lemon is on your list.

Agent

Import example-kitchen.com/recipes/shakshuka and plan it for Friday.

recipe_import_url meal_plan_add

Saved “Shakshuka with feta” and put it on Friday’s dinner.

Chat · Agent mode

What in my pantry expires this week?

pantry_get
  • SpinachFriday
  • Crème fraîcheexpired yesterday

Coconut 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

Looking is free. Changing asks first.

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.

41 read-only
Plans, lists, pantry, recipes, nutrition.
32 write
Add meals, items, recipes.
16 destructive
Remove, clear or replace.
  • Your login stays on your machine, in ~/.samsung-food with owner-only permissions, and renews itself while you use it.
  • No telemetry. It talks to Samsung Food and nothing else.
  • The HTTP API stays local: it binds to 127.0.0.1, needs an API key, and --read-only drops every write tool.

Cooking in one command.

  1. 1Run npx unofficial-samsung-food-mcp setup. It needs Node.js 20 or newer.
  2. 2Log in on the page that opens: one bookmark button on app.samsungfood.com. Samsung has no OAuth, so this hands your session over once.
  3. 3Pick your clients (Claude Code, Claude Desktop, Cursor, VS Code), restart, ask for dinner.

No install at all: the hosted connector (closed beta). Full walkthrough

npx unofficial-samsung-food-mcp setup

Or add it by hand:

Choose your client

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

What it can’t do (yet).

  • No search across all recipes.Search covers your saved recipes. Discover, similar and import bring in new ones.
  • Meals don’t scale.Servings are set when ingredients go to the shopping list.
  • Some sites block imports.Bot protection stops the scraper; you get an error, not a guess.
  • Logins last 14 days.They renew while you use it. After a longer break, run sf login again.

Unofficial.

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