Nutrition 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., "@Nutrition MCP log my lunch: 500 calories, 30g protein"
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
A filesystem-based MCP server that turns any MCP-capable AI agent into a conversational calorie and protein tracker: natural-language estimates, confidence-aware logging, daily/weekly progress, food-history search, and export. Works offline with local fallback data — no API keys required.
Quickstart
The server runs straight from GitHub via npx — no clone, no manual build (it
self-builds on first fetch). You only need Node.js ≥ 20.
The one command every agent uses:
npx -y github:ronkommoji/nutrition-mcpPick your agent:
Agent | Guide |
Hermes Agent | |
Claude Code | |
Codex | |
Cursor / Windsurf / Claude Desktop / other |
Claude Code users can install tools and the skill in one step:
/plugin marketplace add ronkommoji/nutrition-mcp
/plugin install nutrition-mcpRelated MCP server: Calorie Tracker MCP
What's included
MCP server — 8 tools + 2 resources (below).
Skill —
skills/nutrition-tracking/SKILL.md: the estimate → confirm → log policy that makes the tools behave well. Auto-loaded by the Claude plugin; paste into system instructions / AGENTS.md for other agents.
Tools
setup_profile— create a user profile.update_profile— update goals, weight, goal type, or timezone.log_food— store a confirmed meal.undo_last_log— remove the most recent entry.get_daily_status— current day progress.get_weekly_summary— weekly averages and tracked-day metrics.search_food_history— search previous meals.export_logs— export logs as JSON or CSV.
Resources
nutrition://user_profilenutrition://daily_summary
Logging policy
The agent estimates calories and protein itself (its own knowledge plus web
search), shows its assumptions, and logs only after the user confirms.
log_food refuses any entry without userConfirmed: true.
Storage
Data is stored under ~/.nutrition-mcp/ by default (profile.json, logs/,
weekly/, cache/, settings.json). Override with NUTRITION_MCP_HOME.
No API keys
There are none. The agent's own model estimates calories and protein (its
knowledge plus web search), and the server only stores and reports them. The
single optional setting is NUTRITION_MCP_HOME (storage location, default
~/.nutrition-mcp).
Local development
npm install
npm run build # or: npm run dev (tsx watch)
npm startLicense
MIT
Available Tools
8 toolsexport_logsC
Export profile and food logs as JSON or CSV text.
Inputs: format, endDate, startDate.
get_daily_statusA
Return calories, protein, remaining goals, and entries for a day.
Inputs: date.
get_weekly_summaryA
Return weekly calorie and protein averages, best day, and tracked-day count.
Inputs: date.
log_foodA
Store a confirmed food entry. The agent supplies calories and protein (estimated with its own knowledge or web search). Requires userConfirmed: true.
Inputs: protein (required), calories (required), rawEntry (required), userConfirmed (required), +4 more.
search_food_historyB
Search previous logged meals by raw text or parsed food item names.
Inputs: query (required), limit, endDate, startDate.
setup_profileB
Create the nutrition tracking profile used for daily goals and timezone-aware logging.
Inputs: weight (required), goalType (required), dailyCalorieGoal (required), dailyProteinGoal (required), +3 more.
undo_last_logA
Remove the most recent food log entry, optionally constrained to a specific date.
Inputs: date.
update_profileC
Update profile fields such as calorie goal, protein goal, weight, goal type, or timezone.
Inputs: name, weight, goalType, timezone, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools target clearly different actions and resources (logging, daily status, weekly summary, search, export, undo). The only mild overlap is setup_profile vs. update_profile, though the create-vs-modify distinction is spelled out in the descriptions.
All eight names follow a consistent snake_case verb_noun pattern (setup_profile, log_food, get_daily_status, export_logs, etc.). Verb choices are predictable even though they vary by action.
Eight tools is well within the ideal 3-15 range and each maps to a distinct part of the nutrition-tracking workflow. No tool feels redundant or missing for the core loop.
The surface covers profile setup/update, food logging, daily/weekly reads, history search, export, and single-step undo. Minor gaps exist: no way to edit or delete an arbitrary log entry (only undo the last), and no explicit get_profile read despite update/setup coverage.
Maintenance
Related MCP Connectors
Log meals and read your nutrition diary from Claude or ChatGPT.
Persistent food journal for AI assistants. Log meals, save recipes, plan meals and track nutrition.
Log meals and read calories and macros from any AI assistant. Pairs with the whatevr iPhone app.
Calorie, workout and body-weight log inside ChatGPT and Claude. Log meals by text, photo or voice.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that connects AI assistants to your MyFitnessPal data, enabling reading food diaries, nutrition goals, weight measurements, and more via MFP's web scraping.MIT
- FlicenseAqualityDmaintenanceA local, JSON-first calorie and protein tracker for agents and shell workflows, providing a CLI and MCP server for meal tracking, goal management, and summaries with SQLite storage.11-
- FlicenseNot gradedqualityDmaintenanceOffline MCP server for logging workouts, tracking dietary macros, and retrieving daily summaries, all stored in local SQLite. Enables fitness tracking via natural language in MCP-compatible clients.-
- AlicenseNot gradedqualityDmaintenanceMCP server for personal nutrition tracking, enabling users to log meals with calories and macros, water intake, body weight, set goals, and import food diaries from other apps through natural language.MIT