Skip to main content
Glama
NutriClarity MCP

NutriClarity MCP

by nitishkp001

NutriClarity MCP 🥗

CI PyPI Python License: MIT

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.

find_healthier_alternative(barcode, limit=5)

Suggest same-category products with a better Nutri-Score.

add_or_update_product(...)

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-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"]
    }
  }
}

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

OFF_USERNAME

Your account username (not your email). Enables writes when set with the password.

OFF_PASSWORD

Your account password.

OFF_ENVIRONMENT

sandbox (default) or production.

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

Available Tools

5 tools
compare_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

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: search, get product details, get scores, compare, and find alternatives. No overlaps.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case, e.g., search_products, get_product_by_barcode.

    Tool Count5/5

    5 tools are well-scoped for a nutrition-focused server, covering core tasks without being excessive or sparse.

    Completeness4/5

    The tool surface covers search, retrieval, comparison, and recommendation. Missing batch operations or category listing, but core workflows are covered.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      5
      1
      MIT