openfoodfacts-mcp-server — Claude Code MCP server: barcode food lookup
openfoodfacts-mcp-server reads ingredients, allergens, additives and nutrition grades off a packaged food barcode, searches the catalogue by tag, and lines products up side by side.
Apache-2.0 3,148 installs ★ 2 updated 2026-10-17
claude mcp add --transport http openfoodfacts-mcp-server https://openfoodfacts-mcp-server--cyanheads.run.toolsWhat openfoodfacts-mcp-server does
Four tools wrap the Open Food Facts catalogue of crowd-sourced packaged food. off_get_product takes a barcode and returns ingredient text with a parsed tree, allergen and trace tags, additives, Nutri-Score, NOVA and Green-Score grades, plus nutrients per serving and per 100 g (per 100 ml for liquids).
off_search_products runs keyword and tag queries — category, brand, label, allergen, country, nutrient thresholds — joined with AND. off_compare_products puts up to 10 distinct barcodes in one table and leaves gaps empty instead of filling them. off_browse_taxonomy turns a plain word into the tag ID the filters expect. Transport is STDIO or Streamable HTTP, and an openfoodfacts-guide skill sits at skill://openfoodfacts-guide/SKILL.md with guidance on calling the tools.
Keyword and nutrient-filter searches read a text index that trails the live database and stops at the first 10,000 hits. A page holds 50 rows; page_size starts at 20 and is served at 50 max. Pairing additives_tag with a text query fails as additives_filter_needs_tag_search, since additive filtering only works through tag search.
What it helps with
- read a product's ingredients and allergens from its barcode
- shortlist items in one category under a sugar threshold with no milk traces
- compare store brands on Nutri-Score and NOVA
- resolve a plain word into a tag ID for filtering
- see which additives a product lists
Example prompts for the agent
- Look up the barcode on this label and list the allergens and additives.
- Search the breakfast cereals category for Nutri-Score A products without milk.
- Compare the barcodes from that search on sugar and salt.
How to install openfoodfacts-mcp-server
Platform CLI: remote server
claude mcp add --transport http openfoodfacts-mcp-server https://openfoodfacts-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add openfoodfacts-mcp-server --url https://openfoodfacts-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"openfoodfacts-mcp-server": {
"url": "https://openfoodfacts-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"openfoodfacts-mcp-server": {
"type": "http",
"url": "https://openfoodfacts-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http openfoodfacts-mcp-server https://openfoodfacts-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about openfoodfacts-mcp-server
How do I install openfoodfacts-mcp-server in Claude Code?
Run claude mcp add --transport http openfoodfacts-mcp-server https://openfoodfacts-mcp-server--cyanheads.run.tools. The server connects over Streamable HTTP, so nothing runs locally.
What does openfoodfacts-mcp-server do?
It gives the agent four tools over Open Food Facts: a barcode product card, filtered search by tag and nutrient, comparison of up to 10 products, and tag resolution.
Why does additive filtering break when combined with a keyword search?
additives_tag cannot be mixed with query or nutrient_filters; the call returns additives_filter_needs_tag_search. Run a tag-only search for additives instead.