Files: CSV, JSON and GPX on demand
Everything Marrow holds, as a file, whenever you want one. This page lists exactly what each export contains so a spreadsheet, a script or a doctor knows what they are looking at.
All Marrow guides: MCP · Self-hosted mirror · Automations · Files · Support
Where the buttons are
Export, Manual. Pick a range and a format at the top. Each section below makes one file and hands it to the share sheet, so it can go to Files, AirDrop, Mail, or any app that takes a file. Nothing is uploaded anywhere.
Daily metrics
Every Apple Health series Marrow tracks, one value per day, over 30 days, 90 days, a year, or everything. Pick specific metrics or take all of them.
- CSV (
marrow-daily-DATE.csv): one row per day, one column per metric, columns alphabetical, the stored unit in each header:date,active_energy (kcal),body_mass (kg),step_count (count),… - CSV (long) (
marrow-daily-long-DATE.csv):date,metric,value,unit, one row per metric per day. The shape pandas, R and pivot tables want. - JSON (
marrow-daily-DATE.json): the same daily totals as the automation payload.
Two exports of the same data are byte-identical, so files diff and version cleanly.
Nutrition diary
Every logged meal with its full nutrient detail. CSV columns: day,meal,name,grams,kcal,protein_g,carbs_g,fat_g,logged_at,extra, where extra is the JSON of every other nutrient the entry carries (fiber, sugars, sodium, vitamins…). JSON nests entries under days.
Strength log
Every working set (warm-ups are left out) as reps and weight, with the estimated one-rep max, per-exercise progress per session, and volume per muscle group. Weights are in your Settings, Units unit and the column names say which: date,session,exercise,set,weight_lb,reps,est_1rm_lb,set_type (or _kg), where set_type is work, failure or drop.
Symptoms and mood
Every symptom you logged in Apple Health, with Apple's severity in words, and every State of Mind entry with its pleasantness, the feelings you chose and what they were about. CSV or JSON, for tracking or for sharing with a doctor. The same series are also selectable in the daily metrics export and in automations.
Workout routes
One GPX file per workout that recorded GPS in the selected range. Opens in Strava, Google Earth, Komoot, or any mapping tool.
Units
Metric files keep the units Apple Health stores (kg, m, mL, °C, kcal) and always label them, so a spreadsheet or a script never has to guess. The app itself reads in whatever you chose in Settings, Units. Strength files follow that choice too.
Troubleshooting
- No meals, sets or entries in the selected range. Each section exports the range picked at the top of Export, Manual (30 days, 90 days, 1 year or Everything). Pick a longer one, or check that the data is in Marrow first.
- A metric is missing or its column is empty. Marrow can only export what Apple Health lets it read. In the Health app, tap your picture at the top right, then Apps, Marrow, and turn the item on. Then, in Marrow, Settings, Apple Health access, tap Pull again under Reading from Apple Health.
- No workouts with GPS routes in this range. Only workouts that recorded a route, such as outdoor walks, runs and rides, have one. Indoor workouts never do. If you know there are routes, check that Marrow may read Workout Routes in the Health app (Apps, Marrow).
- Couldn't read routes. Apple Health returned an error, named after those words. Try again, and if it repeats, check Workout Routes access as above.
- The share sheet has nowhere to put it. Choose Save to Files to keep the file on the phone or in iCloud Drive, or AirDrop it to a Mac. Any app that opens CSV, JSON or GPX files appears in the share sheet once it is installed.
- A spreadsheet shows one long column. The file is comma separated. Import it as CSV with a comma delimiter instead of opening it as plain text. CSV (long) is easier for pivot tables.
- Numbers look off. Metric files keep Apple Health's stored units (kg, m, mL, °C, kcal) and say so in each header. Strength files follow Settings, Units.
- You export the same thing every week. An automation sends it on a schedule with the app closed.
Steps for one app at a time, Google Sheets and Strava among them, are under connections.
When to choose files
Files are the right answer for a one-off: a spreadsheet, a doctor, a data-science notebook, a backup. If you find yourself exporting on a schedule, an automation does the same thing without you, and an agent that wants to query rather than read a file should use MCP.