Skip to main content
Glama
nutrition-mcp
by asachs01

nutrition-mcp

USDA FoodData Central MCP server for nutrition lookup, meal logging, and daily macro tracking.

Setup

  1. Get a free API key at https://fdc.nal.usda.gov/api-key-signup

  2. Set USDA_API_KEY environment variable (or it falls back to DEMO_KEY)

cp .env.example .env
# Edit .env with your key

Related MCP server: nutrition-mcp

Usage

node src/server.js  # stdio MCP server

Tools

nutrition

Action

Description

Key Params

search

Search foods by name

query, dataType, pageSize

get

Full nutrition details

fdcId

compare

Side-by-side macro comparison

fdcIds (array)

meal_log

Action

Description

Key Params

log

Log a food eaten

fdcId, servings, mealType, date

list

List entries for a date

date, mealType

delete

Remove an entry

entryId

daily_summary

Macro totals for a day

date

weekly_summary

Weekly averages

weekOf

targets

Action

Description

Key Params

set

Set daily macro targets

calories, protein, carbs, fat, fiber

get

View current targets

—

progress

Progress vs targets

date

Architecture

src/
  server.js          — MCP stdio server
  usda-client.js     — USDA API client with 24h cache
  meal-log.js        — Local meal log storage (~/.nutrition-mcp/logs/)
  targets.js         — Macro targets storage (~/.nutrition-mcp/targets.json)
  tools/
    nutrition.js     — nutrition tool handler
    meal-log.js      — meal_log tool handler
    targets.js       — targets tool handler
test/
  server.test.js     — Unit tests

Testing

npm test

License

MIT © Aaron Sachs

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      A local-first nutrition MCP server for food search, barcode lookup, meal estimation, intake logging, hydration, and nutrition coaching workflows.
      46
      492 npm
      11
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Local-first nutrition tracker MCP server for Hermes, enabling food, alias, recipe, and meal log management with SQLite persistence.
      -