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.
/api/v1/healthYour 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.
| Field | In | Type | Meaning |
|---|---|---|---|
| kind * | query | body | sleep | Weight and height, or sleep. |
| range | query | 7d | 30d | 365d | 30d when omitted. |
| timezone | query | IANA zone | Which calendar day "today" is. Your account’s zone when omitted. |
MCP tool: health_entries
/api/v1/health/bodyLog 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.
| Field | In | Type | Meaning |
|---|---|---|---|
| weightKg | body | number | Kilograms. |
| heightCm | body | number | Centimetres. |
| date | body | YYYY-MM-DD | Today when omitted. Never the future. |
| timezone | body | IANA zone | Which day today is. Your account’s zone when omitted. |
{ "weightKg": 72.4 }MCP tool: log_body
/api/v1/health/sleepLog 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.
| Field | In | Type | Meaning |
|---|---|---|---|
| bedTime * | body | HH:MM | When you went to bed. |
| wakeTime * | body | HH:MM | When you woke up. |
| date | body | YYYY-MM-DD | The morning you woke. Today when omitted. |
| timezone | body | IANA zone | Which day today is. Your account’s zone when omitted. |
{ "bedTime": "23:15", "wakeTime": "07:00" }MCP tool: log_sleep