Open Food Facts
Search and contribute to the Open Food Facts database.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
openfoodfacts-mcpclaude mcp add open-food-facts -e 'OFF_USER_AGENT=<OFF_USER_AGENT>' -e 'OFF_USER_ID=<OFF_USER_ID>' -e 'OFF_PASSWORD=<your off_password>' -e 'OFF_COUNTRY=<OFF_COUNTRY>' -- npx -y openfoodfacts-mcp@2.6.0{
"mcpServers": {
"open-food-facts": {
"command": "npx",
"args": [
"-y",
"openfoodfacts-mcp@2.6.0"
],
"env": {
"OFF_USER_AGENT": "<OFF_USER_AGENT>",
"OFF_USER_ID": "<OFF_USER_ID>",
"OFF_PASSWORD": "<your off_password>",
"OFF_COUNTRY": "<OFF_COUNTRY>"
}
}
}
}Variables d'environnement
OFF_USER_AGENTobligatoire User-Agent string in format 'AppName/Version (email)'. Required by the Open Food Facts API.OFF_USER_IDOpen Food Facts user ID (optional, needed for write operations).OFF_PASSWORDsecret Open Food Facts password (optional, needed for write operations).OFF_COUNTRYCountry subdomain (default: 'world').
openfoodfacts-mcpclaude mcp add open-food-facts -e 'MCP_TRANSPORT=<MCP_TRANSPORT>' -e 'OFF_USER_AGENT=<OFF_USER_AGENT>' -e 'OFF_USER_ID=<OFF_USER_ID>' -e 'OFF_PASSWORD=<your off_password>' -e 'OFF_COUNTRY=<OFF_COUNTRY>' -- npx -y openfoodfacts-mcp@2.6.0{
"mcpServers": {
"open-food-facts": {
"command": "npx",
"args": [
"-y",
"openfoodfacts-mcp@2.6.0"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"OFF_USER_AGENT": "<OFF_USER_AGENT>",
"OFF_USER_ID": "<OFF_USER_ID>",
"OFF_PASSWORD": "<your off_password>",
"OFF_COUNTRY": "<OFF_COUNTRY>"
}
}
}
}Variables d'environnement
MCP_TRANSPORTobligatoire Transport type.OFF_USER_AGENTobligatoire User-Agent string in format 'AppName/Version (email)'. Required by the Open Food Facts API.OFF_USER_IDOpen Food Facts user ID (optional, needed for write operations).OFF_PASSWORDsecret Open Food Facts password (optional, needed for write operations).OFF_COUNTRYCountry subdomain (default: 'world').
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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 (you@example.com)). 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 (email@example.com)" |
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 testto 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-tagsto push with tags - Wait for GitHub Actions to publish to the NPM registry.
Questions fréquentes
Qu'est-ce que Open Food Facts ?
Search and contribute to the Open Food Facts database.
Comment installer Open Food Facts ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add open-food-facts -e 'OFF_USER_AGENT=<OFF_USER_AGENT>' -e 'OFF_USER_ID=<OFF_USER_ID>' -e 'OFF_PASSWORD=<your off_password>' -e 'OFF_COUNTRY=<OFF_COUNTRY>' -- npx -y openfoodfacts-mcp@2.6.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Open Food Facts ?
Oui. Il attend OFF_USER_AGENT, OFF_PASSWORD, MCP_TRANSPORT, à renseigner dans sa configuration.
Open Food Facts est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Open Food Facts ?
Il est publié par domdomegg. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.