Skip to main content
Glama
Unofficial Samsung Food MCP

Unofficial Samsung Food MCP

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 (sf)

Meal plan, lists, recipes and pantry in the terminal

HTTP API

A local REST/JSON server (sf serve) with OpenAPI, API key and read-only mode, for scripts, Home Assistant, n8n and Shortcuts; also MCP over HTTP. See docs/http-api.md

Library

The SamsungFood class for your own Node.js code

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 setup

It 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

Getting started

One-command setup, login walkthrough, first commands

MCP clients

Setup for each client

CLI reference

Every sf command

Tool reference

All 89 MCP tools with parameters and examples

Configuration

Environment variables and stored files

Troubleshooting

Expired login, schema drift, rate limits, Windows

FAQ

Terms of service, data, privacy

Architecture

Codec, transport, schema build

Samsung Food API

Protocol reference

HTTP API

Local REST server, OpenAPI, MCP over HTTP

Roadmap

Candidate work, good places to contribute

Website

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

meal_plan_get, meal_plan_add, meal_plan_move, meal_plan_clear

Weekly templates

meal_plan_save_template, meal_plan_apply_template

Shopping lists

shopping_list_get, shopping_list_add, shopping_list_add_recipe

Recipes

recipe_search, recipe_discover, recipe_import_url, recipe_create

Collections

collections_list, collection_add_recipes

Pantry

pantry_get, pantry_add, pantry_consume

Food and nutrition

food_storage_info, food_search, nutrition_analyze

Account and login

account_info, auth_status, auth_login

Raw access

api_methods, api_describe, api_call

The complete list is in the tool reference.

Limitations

  • No global recipe search. recipe_search and sf search only search your own saved recipes. The API has no catalog search by term. Use recipe_discover, recipe_similar and recipe_import_url to 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_recipe with servings).

  • 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 location to pantry_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_url fails with ERROR_RECIPE_SCRAPED_NOTHING for 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides recipe search and authoring, meal planning, shopping lists, and pantry tracking via task-shaped MCP tools.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables managing a personal pantry, shopping lists, cookbook recipes, and saved receipts remotely through MCP tools using natural language or API calls.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      7
      MIT