Unofficial Samsung Food MCP
Allows interaction with Samsung Food's private API to manage meal plans and weekly templates, shopping lists, saved recipes and collections, pantry items, and food/nutrition data, including read-only, write, and destructive operations.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Disclaimer. This project is unofficial. It is not affiliated with, endorsed by, or supported by Samsung or Whisk. "Samsung Food" is a trademark of its owner. It talks to 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. Use it at your own risk. Write tools modify real data in your account, including shared lists and meal plans.
What you can do
Samsung Food has no public API. This project uses the same private API as the web app and gives you four ways to use it:
Way | What it is |
MCP server | 89 tools for Claude, Cursor, VS Code and any other MCP client |
CLI ( | Meal plan, lists, recipes and pantry in the terminal |
HTTP API | A local REST/JSON server ( |
Library | The |
Areas covered: meal plan and weekly templates, shopping lists, recipes and collections, pantry with shelf-life lookup, food and nutrition data, account settings, and raw access to every API method. Example prompts for an AI client: "Plan dinners for next week from my saved recipes and put the ingredients on my shopping list", "What in my pantry expires this week?", "Import this recipe URL".
Related MCP server: tandoor-mcp
Quick start
Requires Node.js 20 or newer and a Samsung Food account.
1. One command
npx unofficial-samsung-food-mcp setupIt logs you in (a page opens in your browser), finds Claude Code, Claude Desktop, Cursor and VS Code,
and asks which of them to configure. Then restart the client and ask: "What's on my meal plan this
week?" Preview first with --dry-run; undo with --remove.
How the login works. Samsung Food has no OAuth or API keys, so the tool takes over the session of
your browser once. The login page shows one button: drag it to your bookmarks bar, open
app.samsungfood.com and click it there. No browser on the machine
(SSH)? sf login --paste. The session grants full access to your account; it stays on your computer.
2. Hosted connector
For ChatGPT or claude.ai without running anything locally: the hosted connector (closed beta).
3. Manual configuration
{
"mcpServers": {
"samsung-food": { "command": "npx", "args": ["-y", "unofficial-samsung-food-mcp"] }
}
}Paths and formats for every client (Claude Desktop, Claude Code, Cursor, VS Code, generic stdio) are
in docs/mcp-clients.md. Log in first with sf login.
From source
git clone https://github.com/derdennis1012/unofficial-samsung-food-mcp.git
cd unofficial-samsung-food-mcp
npm install
npm link # optional: provides `sf` and `unofficial-samsung-food-mcp`Without npm link, use node bin/sf.js in place of sf. Development workflow:
CONTRIBUTING.md.
Documentation
Page | Contents |
One-command setup, login walkthrough, first commands | |
Setup for each client | |
Every | |
All 89 MCP tools with parameters and examples | |
Environment variables and stored files | |
Expired login, schema drift, rate limits, Windows | |
Terms of service, data, privacy | |
Codec, transport, schema build | |
Protocol reference | |
Local REST server, OpenAPI, MCP over HTTP | |
Candidate work, good places to contribute | |
Project page |
Tools at a glance
Every tool is annotated as read-only, write or destructive, validates its input strictly, and returns text plus structured content. Of the 89 tools, 41 are read-only, 32 write and 16 destructive.
Area | Examples |
Meal plan |
|
Weekly templates |
|
Shopping lists |
|
Recipes |
|
Collections |
|
Pantry |
|
Food and nutrition |
|
Account and login |
|
Raw access |
|
The complete list is in the tool reference.
Limitations
No global recipe search.
recipe_searchandsf searchonly search your own saved recipes. The API has no catalog search by term. Userecipe_discover,recipe_similarandrecipe_import_urlto find new recipes.Meals cannot be scaled. A meal stores only the recipe reference. Scaling happens when transferring to the shopping list (
shopping_list_add_recipewithservings).Pantry needs a location for some items. For ingredients that can go in the fridge or the freezer, Samsung Food sets no expiry date. Pass
locationtopantry_add, and the date is computed from the food graph. Without a location the tool warns and does not guess.Not every website can be imported.
recipe_import_urlfails withERROR_RECIPE_SCRAPED_NOTHINGfor sites with bot protection.Some areas have no dedicated tools: community and posts, public profiles, payments and rewards, cart and retailer checkout, account changes (e-mail, password, phone, delete account), and sending links to others. Most are reachable through
api_call, which refuses login and account-credential methods and redacts secrets in results, but otherwise has no safety net.The API can change without notice. If calls start failing, run
sf schema update.Logins last 14 days and renew automatically while you use the tool; after a longer break log in again.
How it works, and what it does not ship
The web app speaks gRPC-Web. This project encodes and decodes those calls with a schema-driven
protobuf codec, so it needs neither protoc nor .proto files. The Samsung protocol schema, the
web app's bundles and the food graph are not distributed with this repository. On first use they
are fetched from Samsung's public web app and CDN onto your own machine and cached in
~/.samsung-food (or $SAMSUNG_FOOD_HOME). The bundles are read as plain text and never executed.
What the source code does contain is the factual interface data needed to talk to the API: RPC
method names, some enum values, field masks and category names as the web app uses them, plus a
small hand-made schema fixture for the offline tests. No telemetry. Details:
Architecture and FAQ.
Contributing, security, license
Contributions are welcome: CONTRIBUTING.md, ROADMAP.md
Report vulnerabilities privately: SECURITY.md. Never attach tokens, cookies or HAR files to issues.
Changes: CHANGELOG.md. Conduct: CODE_OF_CONDUCT.md
License: MIT, see LICENSE. It covers the code in this repository only and grants no rights to Samsung Food, its API, data or trademarks.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
AI-powered recipe platform: 18 MCP tools for meal planning, grocery lists & Instacart.
Recipe search, ingredient matching, nutrition filters and a private cookbook for any AI agent.
Food list analyzer and cited food answers for agents. Also recipes, meal plans and grocery lists.
Household-aware cooking brain: pantry, meal suggestions, dietary safety, recipes, shopping lists.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to read current pantry inventory and low-stock shopping needs, export a shopping queue, and perform idempotent inventory adjustments and catalog link management through remote MCP tools.MIT
- AlicenseNot gradedqualityBmaintenanceProvides recipe search and authoring, meal planning, shopping lists, and pantry tracking via task-shaped MCP tools.MIT

Pantry Buddy MCPofficial
FlicenseNot gradedqualityCmaintenanceEnables managing a personal pantry, shopping lists, cookbook recipes, and saved receipts remotely through MCP tools using natural language or API calls.-- AlicenseAqualityCmaintenanceEnables recipe research and meal planning for MCP-compatible AI hosts, including dish search, recipe inspection, meal plan creation with repeatable writes, and consolidated shopping list generation.7MIT