How do I use nutrition-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@nutrition-mcp log 2 servings of oatmeal for breakfast" 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.

nutrition-mcp

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

Setup

Get a free API key at https://fdc.nal.usda.gov/api-key-signup
Set USDA_API_KEY environment variable (or it falls back to DEMO_KEY)

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

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

This server cannot be installed

A

license - permissive license

-

quality - not tested

D

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

nutrition-mcp

nutrition-mcp

Setup

Usage

Tools

`nutrition`

`meal_log`

`targets`

Architecture

Testing

License

Maintenance

Resources

Latest Blog Posts

MCP directory API