Fitness

Read Fitness: no filter gives the dashboard (current state, newest records); type with from/to lists one kind of record in a period; view 'trends' (metric, period, date for a past week, month or year), 'insights', 'recap' (year) or 'correlations'. ALWAYS pass from/to when the question concerns a period.

Note: No filter returns the dashboard (newest records only); type with from/to lists one kind of record in a period; view 'trends', 'insights', 'correlations' or 'recap' reads those summaries.

{}

Log what the user describes: a workout ('I ran 5k in 28 minutes this morning'; startedAt plus durationSec or endedAt; strength sets with warm-ups marked), sleep or a body measurement in record; water (volumeMl), a meal's totals or a day's activity totals as top-level fields. PRs are detected automatically. Activity totals REPLACE the day's manual entry.

Note: A workout, sleep session or measurement goes in record; water, a meal and a day's activity totals are top-level fields with their type. SI units: kg for weight and lean mass, cm for lengths, percent for body fat. Activity totals replace the day's manual entry.

{
  "type": "workout",
  "record": {
    "activityType": "running",
    "title": "Morning 5K",
    "startedAt": "2026-09-26T07:05:00-05:00",
    "durationSec": 1680,
    "distanceM": 5000
  }
}

Correct one logged workout, sleep session or measurement by type and record.id; only the fields you send change (exercises and stages replace whole when sent). For a day's activity totals send type 'activity' with date and the new values. Water and meal logs can't be edited. Resolve the id with fitness_find first.

Note: Only sent fields change; exercises and stages replace whole when sent. Water and meal logs can't be edited.

{
  "type": "workout",
  "record": {
    "id": "workout_abc",
    "durationSec": 3000
  }
}

Remove one manual entry: a workout (and the PRs it set), sleep session, measurement, water or meal log, by type and id. Only for explicit removals; a synced record is removed in Apple Health or Health Connect. Resolve the id with fitness_find first.

Note: Manual entries only; a record synced from Apple Health or Health Connect is removed there.