Get energy burned
get_energy_expenditureReads- What it does
- Reads only. Changes nothing.
- Permission
- Weight and water, read
body:read
What your assistant is told
Daily energy the user's phone or watch measured — active plus resting
kcal per local day — imported from Apple Health / Health Connect, across
an inclusive local-date range, oldest first. Each row names the device
or app that recorded it (origin).
This is measured input for judging maintenance (set_maintenance), not
a target and not something the user typed. It is only available when
the user has turned on the energy import AND allowed their assistant to
see imported data; otherwise this tool fails with a message saying so —
tell the user where to turn it on (Settings → Health) rather than
guessing a number. Days with no row are days the phone recorded nothing;
do NOT interpolate them.
Parameters
starttext, requiredRange start, local date yyyy-MM-dd.endtext, requiredRange end, inclusive, local date yyyy-MM-dd.