openfoodfacts-mcp

openfoodfacts-mcp

MCP server for the Open Food Facts API - search, read, and contribute to the world's largest open food database.

Use Cases

Look up a product by name: "How many calories in a Sainsbury's buffalo chicken wrap?" -> searches by name, finds the product, and returns nutrition data.

Look up a product by barcode: "What's in this product with barcode 3017620422003?" -> fetches Nutella's ingredients, Nutri-Score, and nutrition data.

Find healthy options: "Search for breakfast cereals with Nutri-Score A" -> searches with category and nutrition grade filters.

Contribute data: "Add the product name and brand for barcode 12345678" -> creates or updates a product entry on Open Food Facts.

Explore the database: "What brands of organic chocolate are in the database?" -> uses autocomplete and search to explore.

Setup

Follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

Set OFF_USER_AGENT to identify your app (e.g. openfoodfacts-mcp/1.2.0 ([e-mail])). For write operations (adding/editing products, uploading images), also set OFF_USER_ID and OFF_PASSWORD.

Environment Variables

Variable	Required	Description
OFF_USER_AGENT	Yes	User-Agent string, e.g. "AppName/1.0 ([e-mail])"
OFF_USER_ID	No	Open Food Facts username (for write operations)
OFF_PASSWORD	No	Open Food Facts password (for write operations)
OFF_COUNTRY	No	Country subdomain (default: world)

Tools

Tool	Description	Auth
get_product	Get product info by barcode	No
search_products_standard	Search with structured filters (brand, category, Nutri-Score)	No
search_products_lucene	Search with Lucene syntax, negation, and boolean logic	No
autocomplete	Autocomplete brands, categories, labels, etc.	No
add_or_edit_product	Add or update a product	Yes
upload_image	Upload a product image	Yes
select_image	Select, crop, and rotate an image	Yes
call_api	Call any OFF API endpoint directly	Depends
get_api_docs	Get OFF API documentation	No

Contributing

Pull requests are welcomed on GitHub! To get started:

• Install Git and Node.js
• Clone the repository
• Install dependencies with npm install
• Run npm run test to run tests
• Build with npm run build

Releases

Versions follow the semantic versioning spec.

To release:

• Use npm version <major | minor | patch> to bump the version
• Run git push --follow-tags to push with tags
• Wait for GitHub Actions to publish to the NPM registry.