NutriClarity MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@NutriClarity MCP compare nutrition of 3017620422003 and 5000112541234"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
NutriClarity MCP 🥗
An open-source Model Context Protocol server that gives any LLM access to food nutrition data — look up products by barcode, search by name, read Nutri-Score / NOVA / Eco-Score ratings, and compare products side by side.
Powered by Open Food Facts, a free, open, crowd-sourced food products database. No API key required.
Tools
Tool | Description |
| Full nutrition facts, scores, allergens & ingredients for a barcode (EAN/UPC). |
| Search products by name or brand; returns barcodes + a nutrition summary. |
| Nutri-Score (A–E), NOVA processing group (1–4), and Eco-Score for a product. |
| Side-by-side per-100g comparison table for 2+ products. |
| Suggest same-category products with a better Nutri-Score. |
| Optional / opt-in. Create or edit a product. Only enabled when credentials are set (see below). |
Reading needs no API key or account — it's open data. Only the optional write tool requires an Open Food Facts login.
Related MCP server: Open Food Facts MCP Server
Quick start
The easiest way to run it is with uvx (no install, no clone):
uvx nutriclarity-mcpClaude Desktop / Cursor / any MCP client
Add this to your MCP config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"nutriclarity": {
"command": "uvx",
"args": ["nutriclarity-mcp"]
}
}
}Then ask things like:
"What's the nutrition of barcode 3017620422003?"
"Search for oat milk and show me the healthiest option."
"Compare Coke and Pepsi nutrition."
Docker
docker run -i --rm ghcr.io/nitishkp001/nutriclarity-mcpMCP config:
{
"mcpServers": {
"nutriclarity": {
"command": "docker",
"args": ["run", "-i", "--rm", "ghcr.io/nitishkp001/nutriclarity-mcp"]
}
}
}Optional: write support (adding/editing products)
By default the server is read-only — no account, no risk. If you want the LLM
to be able to contribute or correct product data, enable the add_or_update_product
tool by providing an Open Food Facts account:
Env var | Description |
| Your account username (not your email). Enables writes when set with the password. |
| Your account password. |
|
|
Writes go to the sandbox by default, so you can
test safely without touching the real database. Set OFF_ENVIRONMENT=production only
when you deliberately want to edit the live, public database. Sandbox accounts are
separate from production accounts — register on each site you target.
{
"mcpServers": {
"nutriclarity": {
"command": "uvx",
"args": ["nutriclarity-mcp"],
"env": {
"OFF_USERNAME": "your-username",
"OFF_PASSWORD": "your-password",
"OFF_ENVIRONMENT": "sandbox"
}
}
}
}⚠️ Open Food Facts is a shared, public database used by millions. If you enable production writes, make sure the data you submit is accurate and taken from the real product label. The tool changes only the fields you pass.
Local development
Requires uv.
git clone https://github.com/nitishkp001/nutriclarity-mcp
cd nutriclarity-mcp
uv sync --extra dev # install deps
uv run nutriclarity-mcp # run the server over stdio
uv run pytest # run tests
uv run ruff check . # lintTo inspect the tools interactively, use the MCP Inspector:
npx @modelcontextprotocol/inspector uv run nutriclarity-mcpHow it works
Built with FastMCP.
Calls the Open Food Facts REST API (
/api/v2/product/{barcode}and/cgi/search.pl).Sends a descriptive
User-Agentas Open Food Facts requests, and asks only for the fields it needs to keep responses small.
Data & attribution
Product data comes from Open Food Facts and is made available under the Open Database License (ODbL). Individual contents are under the Database Contents License. Nutrition data is crowd-sourced and may be incomplete or inaccurate — do not rely on it for medical decisions.
License
MIT © 2026 — see LICENSE. This project is not affiliated with or endorsed by Open Food Facts.
Available Tools
5 toolscompare_productsA
Compare the nutrition of two or more products side by side.
Inputs: barcodes (required). Returns: result
find_healthier_alternativeA
Suggest healthier products in the same category as the given product.
Looks up the product, then searches its category for items with a better (lower) Nutri-Score, returning the healthiest matches first.
Inputs: barcode (required), limit. Returns: result
get_nutrition_scoresA
Get the Nutri-Score, NOVA processing group and Eco-Score for a product.
Inputs: barcode (required). Returns: result
get_product_by_barcodeA
Get full nutrition facts for a food product by its barcode (EAN/UPC).
Inputs: barcode (required). Returns: result
search_productsB
Search food products by name or brand.
Inputs: query (required), page_size. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: search, get product details, get scores, compare, and find alternatives. No overlaps.
All tools follow a consistent verb_noun pattern with snake_case, e.g., search_products, get_product_by_barcode.
5 tools are well-scoped for a nutrition-focused server, covering core tasks without being excessive or sparse.
The tool surface covers search, retrieval, comparison, and recommendation. Missing batch operations or category listing, but core workflows are covered.
Maintenance
Related MCP Connectors
Nutrition data for AI agents and LLMs, powered by Edamam’s database of 1,000,000 foods, including 680,000+ with UPC codes. Lookup via natural language and barcode at low cost and low latency. Highly accurate, deterministic data covering macro and micronutrients, allergens, and lifestyle diet tags.
Food nutrition lookup via natural language, barcode, and image. Database of 1,000,000+ foods.
Look up a packaged food by barcode, search and compare products, and check listed allergens.
Unlock the power of food transparency with our Open Food Facts MCP server. Easily look up any food
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to access the Open Food Facts database to query detailed food product information, nutritional data, and environmental scores. Supports product lookup by barcode, smart search with filtering, nutritional analysis, product comparison, and dietary recommendations to help users make informed food choices.51MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables LLMs to search for food products and retrieve detailed nutritional information from the Open Food Facts database using product names or barcodes.-
- FlicenseBqualityDmaintenanceEnables AI assistants to access food product information, providing nutritional analysis, product comparisons, and recipe suggestions using the Open Food Facts database.21-
- FlicenseBqualityDmaintenanceEnables AI assistants to access food product information from Open Food Facts, including nutritional analysis, product comparisons, recipe suggestions, and allergen checks.21-