Nutrition

Meals

readget_nutrition

Logged meals with ids, calories, macros and original food descriptions. A date returns that day's meals, totals and targets; no arguments defaults to today. A month returns every meal logged in that month. Null nutrition means unknown. created_at is when the record was created, not when the food was eaten.

Access: Reads data and changes nothing.
Annotations: readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: falsetitle: Meals and nutrition
Time limit: 25 seconds, then the call stops with an error.

readget_nutrition

{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "get_nutrition",    "arguments": { "date": "2026-10-14" }  }}

Result

{  "date": "2026-10-14",  "meals": [    {      "id": "cf7b0481-6e56-44ea-942d-19e1f48ba55c",      "name": "<stored_data>Overnight oats with berries</stored_data>",      "calories": 420,      "protein": 24,      "carbs": 58,      "fat": 11,      "source": "manual",      "created_at": "2026-10-14T14:05:12.481+00:00",      "description": "<stored_data>overnight oats with blueberries and a scoop of protein</stored_data>"    }  ],  "totals": {    "calories": 420,    "protein": 24,    "carbs": 58,    "fat": 11  },  "goals": {    "dailyCalories": 2300,    "dailyProtein": 160,    "dailyCarbs": 243,    "dailyFat": 77  },  "targetsUnavailable": false,  "remaining": {    "calories": 1880,    "protein": 136,    "carbs": 185,    "fat": 66  }}

Parameters

datestring
A day as YYYY-MM-DD. Defaults to today.
Format YYYY-MM-DD
monthstring
A month as YYYY-MM, for every meal that month.
Format YYYY-MM

Result

One text item holding a JSON object, as in the example.

Null calories or macros mean unknown, not zero. A null carbs or fat total means a meal lacks that value.
created_at is when a meal was logged, not when it was eaten.
With month (YYYY-MM) it returns { month, meals } for every meal logged that month.

Errors

This tool's own errors, each returned with isError: true:

Meals could not be read.

Every tool returns isError with a message when its arguments don't match the schema, a limit is reached, the person turned the agent off, or iAM360 has a problem. See Errors and limits.

Meals

readget_nutrition

Access

Reads data and changes nothing.

Annotations

readOnlyHint: truedestructiveHint: falseidempotentHint: trueopenWorldHint: falsetitle: Meals and nutrition

Time limit

25 seconds, then the call stops with an error.

{ "date": "2026-10-14", "meals": [ { "id": "cf7b0481-6e56-44ea-942d-19e1f48ba55c", "name": "<stored_data>Overnight oats with berries</stored_data>", "calories": 420, "protein": 24, "carbs": 58, "fat": 11, "source": "manual", "created_at": "2026-10-14T14:05:12.481+00:00", "description": "<stored_data>overnight oats with blueberries and a scoop of protein</stored_data>" } ], "totals": { "calories": 420, "protein": 24, "carbs": 58, "fat": 11 }, "goals": { "dailyCalories": 2300, "dailyProtein": 160, "dailyCarbs": 243, "dailyFat": 77 }, "targetsUnavailable": false, "remaining": { "calories": 1880, "protein": 136, "carbs": 185, "fat": 66 }}

Result

One text item holding a JSON object, as in the example.

Null calories or macros mean unknown, not zero. A null carbs or fat total means a meal lacks that value.
created_at is when a meal was logged, not when it was eaten.
With month (YYYY-MM) it returns { month, meals } for every meal logged that month.