Start with Health.md

Available now · signed Mac helper

Export health data, connect a local agent, or use a versioned contract. HealthKit stays on iPhone. Health Connect stays on Android.

$ "/Applications/Health.md.app/Contents/Helpers/healthmd" doctor

For a different install location, copy the helper path from Health.md for Mac → CLI.

First iPhone Export Connect an Agent Browse Contracts

01 · ExportStart on iPhoneAuthorize Apple Health, choose a folder, preview the output, and export one day. 02 · AskConnect a local agentConnect Codex or Claude to the signed Mac helper. Then request a limited data scope. 03 · BuildUse stable contractsUse versioned schemas, records, evidence, fixtures, and response envelopes.

21bundled Mac MCP tools

4export formats

v8Apple public export schema

0required Health.md cloud hops

Available now · macOS

Ten-minute local agent quickstart

Use the signed Mac helper with a connected iPhone. This example checks setup, lists sleep metrics, and queries one day.

HMD="/Applications/Health.md.app/Contents/Helpers/healthmd"
"$HMD" doctor
"$HMD" metrics list --category Sleep
"$HMD" query --category Sleep --yesterday

A ready doctor result uses the healthmd.cli_doctor schema. It gives the next action when setup is incomplete.

For Codex or Claude, configure the separate healthmd-mcp helper.

Agent configuration reference →

Choose by goal

Configure and connect

Available now · MacConnect Codex, Claude, or another stdio client. Available now · MacReview the 21 bundled tools, private visualizations, and portable preview. Available now · MacInstall the helper, check setup, and query data. ArchitectureReview scope, trust, evidence, retention, and privacy.

Everyday operations

Query, extract, and automate

Typed queriesQuery metrics, sleep, workouts, comparisons, coverage, and evidence. Preview · portable CLIPair a phone through Manual IP or Tailscale. Review current device compatibility. Source dataExtract schema-v8 days, source records, projections, or JSONL. Reliable runsHandle timeouts, unknown outcomes, resumed jobs, canceled jobs, and partial results. Low levelUse loopback routes for queries, evidence, cursors, refreshes, and durable jobs. PatternsParse and validate Health.md output without changing its contract.

Stable interfaces

Data contracts and structures

Contract mapBrowse schemas, metrics, formats, records, and test fixtures. AutomationReview envelopes, routes, exit behavior, and generated examples. Agent resultsReview typed values, coverage, missing data, operations, and stable identities. Schema v8Review the public source document and its ownership rules. VocabularyUse stable metric IDs, categories, units, and profile metadata. Machine-readableOpen canonical fields, fixtures, message lists, and CLI contracts.

Product workflows

Apps and exports

Export profiles

• Choose Summary or shared Detailed Time-Series output. Lossless Health Records is available only on Apple platforms.
• Save separate settings, destinations, and schedules in local profiles.
• A stop or cancel action affects only the active attempt. Completed dates stay complete, and unresolved dates remain available to retry. The action does not disable a recurring schedule.

Read Export profiles for stable IDs, automation, destination history, and failure behavior.

Repeatable workflowsSave settings, destinations, schedules, and an automation identity. Start here · iPhoneAuthorize Apple Health, select a folder, preview output, and verify files. AndroidSelect a document-provider folder and configure Android automation. FilesExport a date range as Markdown, CSV, JSON, or Obsidian Bases. StructureSet units, dates, frontmatter, filenames, and write behavior. BackgroundReview schedules, recovery, and platform timing limits. AutomationStart exports, summaries, and status checks from Apple workflows.

Documentation structure updated 2026-08-31