Nutrition MCP

What is Nutrition MCP about?

Nutrition MCP provides a conversational interface for personal nutrition tracking. Users can log meals (including calories, macros, fiber, sugar, caffeine, and optional alcohol), record water consumption and body weight, view daily or historical nutrition summaries, and import data from other trackers.

How to use Nutrition MCP?

1. Connect – In Claude.ai (or any MCP‑compatible client) add a custom connector with the URL https://nutrition-mcp.com/mcp.
2. Register – On first connection, create an account with an email and password (or optionally sign in with Google).
3. Interact – Ask the assistant to log a meal, retrieve today’s nutrition, set goals, import a CSV export, etc. The server authenticates the user via OAuth 2.0 and stores data in Supabase.
4. Self‑host (optional) – Follow the README: set up a Supabase project, define the required environment variables, run bun install && bun run dev locally or deploy the provided Dockerfile.

Key Features of Nutrition MCP

• Rich meal logging – description, type, calories, all macronutrients, fiber, sugar, caffeine, alcohol, notes, and photo‑based barcode lookup via Open Food Facts.
• Water & weight tracking – milliliter‑level hydration entries and kilogram/pound weight logs with trend analysis.
• Goal management – daily calorie/macronutrient/fiber/water targets, limits for sugar/alcohol/caffeine, optional target weight.
• Historical insights – daily summaries, multi‑day aggregates, streaks, day‑of‑week patterns, meal patterns, and visual widgets.
• CSV import/export – in‑chat bulk import (up to 50 rows per call) and export with a 60‑minute download link.
• Customizable settings – timezone, widget display, alcohol tracking preferences, weight unit, and OAuth client configuration.
• MCP tools – a comprehensive set of RPC‑style tools (log_meal, get_meals_today, set_nutrition_goals, export_meals, etc.) for seamless integration.

Use Cases of Nutrition MCP

• Daily diet journaling – quickly log meals and drinks during a conversation with Claude.ai.
• Goal‑driven tracking – set specific macro or water targets and receive real‑time progress feedback.
• Data migration – import existing CSV exports from MyFitnessPal, Cronometer, Lose It!, MacroFactor, or any custom file.
• Analytics & trends – view 7/14/30‑day averages, streaks, and pattern insights to adjust eating habits.
• Developer integration – expose MCP tools to any AI model or custom front‑end for programmatic nutrition management.

FAQ from the Nutrition MCP

Q: Do I need a Supabase account to use the hosted version? A: No. The hosted service runs its own Supabase instance; you only need to create an account on the connector.

Q: Is alcohol tracking enabled by default? A: It is off by default. Turn it on with set_alcohol_tracking before importing data that contains an alcohol column.

Q: Can I use the server without Bun? A: The project is built with Bun, but you can run it in any environment that supports Node via the Docker image provided.

Q: How secure is my data? A: Authentication uses OAuth 2.0 and Supabase’s RLS policies. The service role key is kept server‑side; only your credentials are stored.

Q: What if I want to host it on my own domain? A: Run bun run depersonalize to remove the maintainer’s branding, replace placeholder assets, and set your domain in the environment before deploying.

Nutrition MCP

A remote MCP server for personal nutrition tracking — log meals with calories, macros, fiber, total sugar and caffeine, log water and body weight, review nutrition history, and import an existing food diary from another app, all through conversation. Alcohol tracking is opt-in and off by default.

Help me pay for the servers on Patreon

Quick Start

Already hosted and ready to use — just connect it to your MCP client:

https://nutrition-mcp.com/mcp

On Claude.ai: Customize → Connectors → + → Add custom connector → paste the URL → Connect

On first connect you'll be asked to register with an email and password. Your data persists across reconnections.

Switching from another tracker? See the nutrition-app alternatives — how it compares to MyFitnessPal, Cronometer, Lose It!, MacroFactor, Yazio, and Lifesum. Bring your history with you: say "import my meals" and an importer opens in the chat, where you pick the CSV you exported from your old app, map its columns, and check what will be added before anything is saved. Exports from MyFitnessPal, Cronometer, Lose It! and MacroFactor are recognised automatically; any other CSV works by mapping its columns yourself. In clients that can't show in-chat panels, paste the export instead and the AI imports it for you. If your export has an alcohol column and you want it kept, turn alcohol tracking on before importing — the importer skips that column while tracking is off, and re-importing the same file later won't backfill it.

Demo

Read the story behind it: How I Replaced MyFitnessPal and Other Apps with a Single MCP Server

Tech Stack

• Bun — runtime and package manager
• Hono — HTTP framework
• MCP SDK — Model Context Protocol over Streamable HTTP
• Supabase — PostgreSQL database + user authentication
• OAuth 2.0 — authentication for Claude.ai connectors

MCP Tools

Tool	Description
log_meal	Log a meal with description, type, calories, macros, fiber, total sugar, alcohol, caffeine (mg), notes — from text or a photo of your plate
start_meal_import	Open the in-chat CSV importer: pick an export from another app, map its columns, preview, confirm
bulk_import_meals	Write up to 50 imported rows per call — each row validated, duplicates skipped so a re-send is safe
lookup_barcode	Look up a packaged product's label nutrition by barcode via Open Food Facts (read from a photo or typed)
get_meals_today	Get all meals logged today
get_meals_by_date	Get meals for a specific date (YYYY-MM-DD)
get_meals_by_date_range	Get meals between two dates (inclusive)
search_meals	Search past meals by keyword, grouped into recurring variations (counts, last logged, typical macros)
get_nutrition_summary	Daily nutrition totals + goal progress for a date range
update_meal	Update any fields of an existing meal
delete_meal	Delete a meal by ID
set_nutrition_goals	Set daily calorie, macro, fiber and water targets to reach, sugar/alcohol/caffeine limits to stay under, plus an optional target weight
get_nutrition_goals	Get the current daily targets and limits
get_goal_progress	Get intake vs. targets and limits for a given day (default: today), plus latest weight vs. target
log_water	Log a hydration entry in milliliters
get_water_today	Get today's water intake total and entries
get_water_by_date	Get water intake for a specific date
delete_water	Delete a water log entry by ID
log_weight	Log a body-weight measurement in kg or lb (converted and stored server-side)
get_weight_today	Get today's weight entries
get_weight_by_date	Get weight entries for a specific date
get_weight_by_date_range	Get weight entries between two dates (inclusive), grouped by day
get_weight_trends	Weight trend: latest, overall change, 7/14/30-day moving averages, min/max, and goal progress
update_weight	Update an existing weight entry
delete_weight	Delete a weight entry by ID
set_weight_unit	Set the preferred weight unit (kg or lb; null to clear)
get_weight_unit	Get the preferred weight unit
get_trends	7/14/30-day averages, std dev, streaks, day-of-week, best/worst day
get_meal_patterns	Pre-aggregated behavioural patterns (breakfast effect, late dinner, weekend vs weekday, outliers)
export_meals	Export all meals as a CSV and return a 60-minute download link
set_timezone	Set the user's IANA timezone (e.g. America/Los_Angeles)
get_timezone	Get the user's configured timezone, plus their current local date and time
get_current_time	Get the current date and time in the user's timezone, plus the UTC instant — for hosts with no clock in context
set_widget_display	Enable or disable the in-chat visual widgets (dashboards, rings, charts); enabled by default
get_widget_display	Get whether the in-chat visual widgets are enabled
set_alcohol_tracking	Turn alcohol tracking on or off (off by default) and choose US standard drinks or UK units; turning it off hides alcohol rather than deleting it
get_alcohol_tracking	Get whether alcohol tracking is on and which standard drink it's displayed in
delete_account	Permanently delete account and all associated data

MCP Resources

URI	Description
nutrition://weekly-summary	Rolling 7-day digest (averages vs targets, best/roughest day) for proactive pulls

Self-hosting

1. Supabase setup

1. Create a Supabase project.

2. Enable Email Auth (Authentication → Providers → Email) and disable email confirmation.

3. Apply the schema. The full schema lives in supabase/migrations/. With the Supabase CLI:

   supabase link --project-ref <your-project-ref>
   supabase db push
   

   This creates every table, index, RLS policy, and foreign key the app needs. No local Postgres is involved — migrations run against your hosted project.

4. Copy the service role key from Project Settings → API and use it as SUPABASE_SECRET_KEY.

2. Environment variables

Variable	Description
SUPABASE_URL	Your Supabase project URL
SUPABASE_SECRET_KEY	Supabase service role key (bypasses RLS)
OAUTH_CLIENT_ID	Random string for OAuth client identification
OAUTH_CLIENT_SECRET	Random string for OAuth client authentication
GOOGLE_CLIENT_ID	(optional) Google OAuth client ID for "Sign in with Google"
GOOGLE_CLIENT_SECRET	(optional) Google OAuth client secret
OFF_USER_AGENT	Open Food Facts User-Agent for barcode lookups, in the form AppName (email)
PORT	Server port (default: 8080)

Making it yours: The public site includes the maintainer's personal bits — Google Analytics, Patreon/GitHub/contact links, and the nutrition-mcp.com domain. Run bun run depersonalize to strip them all in one pass (analytics + CSP, the Support/Contact sections, social links, and the domain → a your-domain.com placeholder). Use bun run depersonalize --dry to preview without writing. Afterwards, swap in your own public/og.png, favicon.ico, and apple-touch-icon.png, and replace the domain placeholder with your real domain.

Generate OAuth credentials:

openssl rand -hex 16   # use as OAUTH_CLIENT_ID
openssl rand -hex 32   # use as OAUTH_CLIENT_SECRET

3. Google sign-in (optional)

Email/password works out of the box. To also offer "Continue with Google", follow docs/google-auth-setup.md to create a Google OAuth client, enable the Google provider in Supabase, and set GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET.

Development

bun install
cp .env.example .env   # fill in your credentials
bun run dev             # starts with hot reload on http://localhost:8080

Connect to Claude.ai

1. Open Claude.ai and click Customize
2. Click Connectors, then the + button
3. Click Add custom connector
4. Fill in:
   • Name: Nutrition Tracker
   • Remote MCP Server URL: https://nutrition-mcp.com/mcp
5. Click Connect — sign in or register when prompted
6. After signing in, Claude can use your nutrition tools. If you reconnect later, sign in with the same email and password to keep your data.

API Endpoints

Endpoint	Description
GET /health	Health check
GET /.well-known/oauth-authorization-server	OAuth metadata discovery
POST /register	Dynamic client registration
GET /authorize	OAuth authorization (shows login page)
POST /approve	Login/register handler
POST /token	Token exchange
GET /favicon.ico	Server icon
ALL /mcp	MCP endpoint (authenticated)

Deploy

The project includes a Dockerfile for container-based deployment.

1. Push your repo to a hosting provider (e.g. DigitalOcean App Platform)
2. Set the environment variables listed above
3. The app auto-detects the Dockerfile and deploys on port 8080
4. Point your domain to the deployed URL

License

MIT