Logging Tools
Save meals, supplements, water and body measurements the user mentions.
Each tool saves one entry the way the app saves it. Times are ISO-8601 instants (e.g. 2026-10-16T13:05:00Z) within the last 30 days; omit them for now. The same entry sent again within 10 minutes is treated as a retry and saved once. Tell the user what you saved.
log_meal
A meal or snack. Give at least one number, known or estimated, and tell the user that estimated numbers can be edited in the app.
| Parameter | Notes |
|---|---|
mealLabel | Required. Short name, e.g. "Oatmeal with banana" |
eatenAt | When it was eaten |
kcal, proteinG, carbsG, fatG, fiberG, sugarG, sodiumMg | Nutrients, in kcal, grams and milligrams |
description | Longer description of what was in it |
log_supplement
A supplement or medication dose, e.g. "Magnesium glycinate 400 mg".
| Parameter | Notes |
|---|---|
name | Required. E.g. "Vitamin D3" |
serving | As the user said it, e.g. "2000 IU" or "1 capsule" |
takenAt | When it was taken |
log_water
| Parameter | Notes |
|---|---|
ml | Required. Millilitres (1 fl oz = 29.6 ml) |
takenAt | When |
log_measurement
A body measurement the user took themselves.
| Parameter | Notes |
|---|---|
type | Required. weight, blood_pressure, body_fat (percent) or waist |
value | The reading, for weight, body_fat or waist |
unit | kg or lb for weight; cm or in for waist |
systolic, diastolic | mmHg, for blood_pressure |
measuredAt | When it was measured |
Permission: log:write