Lifous

Health

The health endpoints of the Lifous API.

A * marks a required field. Path fields go in the address, query fields after a ?, body fields in JSON.

GET/api/v1/health

Your weight or sleep

Weight and height (kind=body), or nights of sleep (kind=sleep), over a week, a month or a year, with the recent entries. Weight is in kilograms and height in centimetres; a night is filed under the morning, with bed and wake times as minutes after midnight. `agreed: false` until you have agreed to keep health data on the website or in the app.

FieldInTypeMeaning
kind *querybody | sleepWeight and height, or sleep.
rangequery7d | 30d | 365d30d when omitted.
timezonequeryIANA zoneWhich calendar day "today" is. Your account’s zone when omitted.

MCP tool: health_entries

POST/api/v1/health/body

Log weight or height

Writes your weight, your height, or both for a day (today unless you say which). A second entry for the same day replaces the first. Answers 412 until you have agreed to keep health data on the website or in the app.

FieldInTypeMeaning
weightKgbodynumberKilograms.
heightCmbodynumberCentimetres.
datebodyYYYY-MM-DDToday when omitted. Never the future.
timezonebodyIANA zoneWhich day today is. Your account’s zone when omitted.
Body
{ "weightKg": 72.4 }

MCP tool: log_body

POST/api/v1/health/sleep

Log a night of sleep

Writes when you went to bed and when you woke, filed under the morning you woke (today unless you say which). A second entry for the same morning replaces the first. Answers 412 until you have agreed to keep health data.

FieldInTypeMeaning
bedTime *bodyHH:MMWhen you went to bed.
wakeTime *bodyHH:MMWhen you woke up.
datebodyYYYY-MM-DDThe morning you woke. Today when omitted.
timezonebodyIANA zoneWhich day today is. Your account’s zone when omitted.
Body
{ "bedTime": "23:15", "wakeTime": "07:00" }

MCP tool: log_sleep