Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http openfoodfacts-mcp-server https://openfoodfacts-mcp-server--cyanheads.run.tools
Open on GitHub

What 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.tools

Step 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.

Similar MCP servers

All MCP servers for Data and databases →

Project sponsors

Companies that keep this analytics open