Skip to content

Mac Sync

Mac Sync lets your Mac receive exports without becoming a HealthKit reader. The iPhone remains the source of truth for Apple Health data, builds the export using your selected metrics, formats, date range, filenames, and write mode, then sends the job to the Mac. The Mac writes the received files into the destination folder you chose.

iPhoneReads HealthKit and applies your export settings. Local networkSends the export job to the nearby Mac app. MacReceives the files and writes them to the chosen folder. VaultObsidian, iCloud Drive, or any local folder gets the final export.
  1. Install and open the macOS app.
  2. On Mac, choose a destination folder so Health.md has write access.
  3. On iPhone, open the Sync tab and enable Mac connectivity.
  4. Return to the iPhone Export tab, choose Connected Mac, configure the export, and tap Export.
  • The exported files or export job payload for the date range you selected on iPhone
  • Your metric selection, formats, filenames, folder structure, and write mode
  • Status and readiness messages from the Mac destination

No account or remote health-data cloud is required. Both devices need local-network access and must be able to discover each other.

Desktop-only vaults

If your Obsidian vault lives only on the Mac, this is the clean path from iPhone HealthKit to Mac files.

Large backfills

Keep final files on a desktop disk while the iPhone handles the HealthKit read and export configuration.

Local archive workflows

Write directly into folders that are backed up, versioned, or indexed on macOS.

Local network required.

Both devices must be nearby and allowed to use local networking. Cellular-only iPhones cannot discover a Mac destination. If readiness says the Mac needs attention, reopen the Mac app and reselect the destination folder.