nutriclarity-mcp 0.1.0

MCP server for food nutrition data (barcode lookup, search, Nutri-Score/NOVA/Eco-Score, comparison) powered by Open Food Facts.

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
get_product_by_barcode(barcode)	Full nutrition facts, scores, allergens & ingredients for a barcode (EAN/UPC).
search_products(query, page_size=5)	Search products by name or brand; returns barcodes + a nutrition summary.
get_nutrition_scores(barcode)	Nutri-Score (A–E), NOVA processing group (1–4), and Eco-Score for a product.
compare_products(barcodes)	Side-by-side per-100g comparison table for 2+ products.

Quick start

The easiest way to run it is with uvx (no install, no clone):

uvx nutriclarity-mcp

Claude 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-mcp

MCP config:

{
  "mcpServers": {
    "nutriclarity": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/nitishkp001/nutriclarity-mcp"]
    }
  }
}

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 .        # lint

To inspect the tools interactively, use the MCP Inspector:

npx @modelcontextprotocol/inspector uv run nutriclarity-mcp

How it works

• Built with FastMCP.
• Calls the Open Food Facts REST API (/api/v2/product/{barcode} and /cgi/search.pl).
• Sends a descriptive User-Agent as 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.