Daily Nutrition reference

Read each day's calorie and macro totals against the calorie and protein targets the app shows.

The DailyGoal API is not available on the Free plan. It works with a paid plan or during a free trial. See plans.

Operations

get_daily_nutrition: Get daily nutrition

get_daily_nutrition

GET https://api.dailygoal.fit/v1/nutrition

MCP tool get_daily_nutrition · Read-only

Returns each day's total calories, protein, carbs, fat and alcohol from the food diary, with the calorie and protein targets the app measures them against, for one day or a range of up to 31 days. Omit both dates for today; send `from` alone for every day from then to today. To see the individual entries use list_food_entries; for goal progress use get_daily_goals.

Input

Field	Type	Description
fromoptional	string (YYYY-MM-DD)	First day, YYYY-MM-DD. Defaults to `to`, so omitting both reads today alone.
tooptional	string (YYYY-MM-DD)	Last day, YYYY-MM-DD. Defaults to today's Activity Day.

Output

Field	Type	Description
from	string (YYYY-MM-DD)
to	string (YYYY-MM-DD)
timezone	string	IANA timezone that defines the user's Activity Day.
targets	object	Targets from the current profile settings and latest readings, the same for every day in the range. Change them with update_profile_settings.
targets.calories	number	Daily calorie target: maintenance calories minus the profile's calorie deficit.
targets.maintenanceCalories	number	Estimated calories to hold weight, from the profile and the latest weight and body fat.
targets.protein	number	Daily protein target in grams: the latest weight in kg times the profile's protein multiplier.
days	object[]	One row per day in the range, oldest first, including days with nothing logged.
days[].date	string (YYYY-MM-DD)
days[].entryCount	integer	Diary entries logged that day.
days[].calories	number	Calories logged, rounded to whole kcal.
days[].protein	number	Grams, rounded to 0.1.
days[].carbs	number	Grams, rounded to 0.1.
days[].fat	number	Grams, rounded to 0.1.
days[].alcohol	number	Grams, rounded to 0.1.
days[].caloriesRemaining	number	Calorie target minus calories logged; negative when over the target.

Example request

REST

curl "https://api.dailygoal.fit/v1/nutrition?from=2026-09-12" \
  -H "Authorization: Bearer $DAILYGOAL_API_TOKEN"

MCP tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_daily_nutrition",
    "arguments": {
      "from": "2026-09-12"
    }
  }
}

Example response

Synthetic data. REST returns this object as the body; MCP returns it as structuredContent.

json

{
  "from": "2026-09-12",
  "to": "2026-09-14",
  "timezone": "Europe/London",
  "targets": {
    "calories": 1940,
    "maintenanceCalories": 2340,
    "protein": 140
  },
  "days": [
    {
      "date": "2026-09-12",
      "entryCount": 6,
      "calories": 2012,
      "protein": 131.4,
      "carbs": 214.8,
      "fat": 71.2,
      "alcohol": 9.6,
      "caloriesRemaining": -72
    },
    {
      "date": "2026-09-13",
      "entryCount": 5,
      "calories": 1876,
      "protein": 146.2,
      "carbs": 188.5,
      "fat": 60.3,
      "alcohol": 0,
      "caloriesRemaining": 64
    },
    {
      "date": "2026-09-14",
      "entryCount": 2,
      "calories": 524,
      "protein": 40.2,
      "carbs": 65.6,
      "fat": 11.2,
      "alcohol": 0,
      "caloriesRemaining": 1416
    }
  ]
}