Reference

Everything your AI can do

You never call these directly — you just talk, and the assistant picks the right tool. Here's the full set the Nutrition MCP server exposes, with what each one does and a phrase that triggers it.

30 tools across 7 areas

Logging food & meals

The core loop — capture what you ate, however you describe it.

log_meal Log

Log what you ate with calories and macros. Describe it in plain language — the AI estimates the numbers, asks about portion size when it's unclear, and can pull verified data from a barcode or the web first.

Parameters

description required — What was eaten
calories optional — Total calories
protein_g optional — Protein in grams
carbs_g optional — Carbohydrates in grams
fat_g optional — Fat in grams
notes optional — Additional notes

Try saying

Log a chicken burrito bowl with extra guac for lunch

…or just snap a photo of your plate — the AI reads it and logs it.

lookup_barcode Look up

Fetch a packaged product's verified nutrition from Open Food Facts by its barcode (8–14 digit EAN/UPC). You can type the digits or read them off a photo of the package; the result can then be logged, scaled to how much you ate.

Try saying

Scan this barcode: 3017620422003

…or send a photo of the package — the AI reads the barcode digits off it.

update_meal Edit

Change the details of a meal you already logged — its description, any macro, the time, or notes.

Parameters

id required — UUID of the meal to update
description optional
calories optional
protein_g optional
carbs_g optional
fat_g optional
logged_at optional
notes optional

Try saying

Actually that lunch was 600 calories, not 500 — fix it

delete_meal Remove

Remove a meal entry you logged by mistake.

Parameters

id required — UUID of the meal to delete

Try saying

Delete the snack I logged this afternoon

Reviewing your meals

Look back over what you've logged, one day or a whole range at a time.

get_meals_today View

See every meal you've logged today.

Try saying

What have I eaten today?

get_meals_by_date View

See all the meals you logged on a specific day.

Parameters

date required — Date in YYYY-MM-DD format

Try saying

Show me everything I ate on July 4th

get_meals_by_date_range View

Pull all meals between two dates in one go — handy for reviewing a week or a month.

Parameters

start_date required — Start date (YYYY-MM-DD)
end_date required — End date (YYYY-MM-DD)

Try saying

List my meals from Monday to Friday

export_meals Export

Export your full meal history as a CSV and get a private download link that stays valid for 60 minutes.

Try saying

Export all my meals to a CSV I can download

Water

Track hydration alongside your food.

log_water Log

Log a hydration entry. Give it in any unit — cups, ounces, liters — and it's converted to millilitres for you.

Parameters

amount_ml optional — Amount in milliliters (integer, > 0).

Try saying

I just drank a 500 ml bottle of water

get_water_today View

See today's total water intake and each entry.

Try saying

How much water have I had today?

get_water_by_date View

See your water total and entries for a specific day.

Parameters

date required — Date in YYYY-MM-DD format

Try saying

How much did I drink yesterday?

delete_water Remove

Remove a water entry you added by mistake.

Parameters

id required — UUID of the water entry to delete

Try saying

Remove that last water entry

Weight

Log weigh-ins, review them, and watch the trend toward your target.

log_weight Log

Record a body-weight measurement in kg or lb. Multiple weigh-ins per day are fine, and the server stores it canonically so your unit preference never distorts the number.

Parameters

weight optional — Body weight value, in `unit` (> 0).

Try saying

Log my weight — 74.2 kg this morning

update_weight Edit

Correct an existing weigh-in — the value, the timestamp, or its notes.

Parameters

id required — UUID of the weight entry to update
weight optional — New weight value, in `unit`.
logged_at optional — ISO 8601 timestamp
notes optional

Try saying

Fix this morning's weigh-in to 73.8 kg

delete_weight Remove

Remove a weight entry.

Parameters

id required — UUID of the weight entry to delete

Try saying

Delete today's weight entry

get_weight_today View

See today's weigh-ins, shown in your preferred unit.

Try saying

What did I weigh today?

get_weight_by_date View

See your weigh-ins for a specific day.

Parameters

date required — Date in YYYY-MM-DD format

Try saying

What was my weight on the 1st?

get_weight_by_date_range View

Get every weigh-in between two dates, grouped by day with each day's average.

Parameters

start_date required — Start date (YYYY-MM-DD)
end_date required — End date (YYYY-MM-DD)

Try saying

Show my weigh-ins for the last two weeks

get_weight_trends View

See your weight trend over a window: latest reading, overall change, 7/14/30-day moving averages, min/max, and progress toward your target weight.

Parameters

days optional — Window size in days (default 30, max 365).

Try saying

How's my weight trending this month?

set_weight_unit Setting

Choose whether weights show and are entered in kg or lb. Stored values are unaffected — only display and default parsing change.

Try saying

Use pounds for my weight from now on

get_weight_unit View

Check which weight unit you're currently using.

Try saying

What weight unit am I using?

Goals & progress

Set targets and see how each day measures up.

set_nutrition_goals Setting

Set your daily calorie, protein, carb, water and macro targets, plus an optional target body weight. Update only the fields you name; the rest stay put.

Parameters

daily_calories optional — Daily calorie target (kcal). Null to clear.
daily_protein_g optional — Daily protein target (grams). Null to clear.
daily_carbs_g optional — Daily carbs target (grams). Null to clear.
daily_fat_g optional — Daily fat target (grams). Null to clear.
daily_water_ml optional
target_weight optional

Try saying

Set my goals to 2,200 calories, 160 g protein, and a 75 kg target weight

get_nutrition_goals View

See your current daily calorie and macro targets.

Try saying

What are my daily targets?

get_goal_progress View

See how today's intake stacks up against your goals — intake-vs-goal rings plus body-weight progress. Tap a macro ring to see which meals contributed.

Try saying

How am I doing against my goals today?

get_nutrition_summary View

Get daily nutrition totals across a date range as an interactive dashboard: macro tiles vs. goals and a per-day breakdown.

Parameters

start_date required — Start date (YYYY-MM-DD)
end_date required — End date (YYYY-MM-DD)

Try saying

Give me a summary of this past week

Insights & trends

Pre-aggregated analysis so the AI can spot patterns without doing arithmetic.

get_trends View

Rolling 7/14/30-day averages, variability, logging streaks, day-of-week breakdowns, and your best and worst days for calories and each macro — pre-computed so the AI can just narrate them.

Parameters

days optional — Window size in days (default 30, max 365).

Try saying

What are my calorie and macro trends over the last 30 days?

get_meal_patterns View

Surface behavioural patterns: how often you eat each meal type, the breakfast effect, high-calorie lunches, late dinners, weekday vs weekend, and outlier days.

Parameters

days optional — Window end date YYYY-MM-DD (default today).

Try saying

Any patterns in how I eat — like late dinners or skipping breakfast?

Settings & account

Preferences that keep everything accurate, plus full control of your data.

set_timezone Setting

Set your IANA timezone so days roll over at your local midnight — a meal logged at 11pm counts on that day, not the next UTC one.

Try saying

I'm in Berlin — set my timezone

get_timezone View

Check the timezone you're configured for (defaults to UTC if unset).

Try saying

What timezone am I set to?

delete_account Remove

Permanently delete your account and all associated data. This is irreversible — the AI always confirms with you first.

Try saying

Delete my account and all my data