health.md icon health.md
Core Feature · Cross-Device

Mac Sync

Locally pair your iPhone with the macOS app over Wi-Fi or Bluetooth. The Mac requests data, the iPhone fulfills it, and exports land directly on your desktop — no cloud service, no account.

Sync tab
Sync tab

What it is

Mac Sync turns the iPhone into a data source for the macOS companion app. The Mac runs the export pipeline (same engine, same templates), but pulls the raw HealthKit data from your phone over the local network.

How to enable

  1. Install the macOS app from the Mac App Store.
  2. Open the Mac app, sign into the same iCloud account you use on iPhone (only used for device discovery).
  3. On iPhone, open the Sync tab and turn on Sync to Mac.
  4. The Mac and iPhone discover each other on your local network and pair automatically.

What's transferred

No raw HealthKit data leaves your devices' local network. The transport is end-to-end encrypted within Apple's network framework.

When to use it

Long-running exports

Years of historical data is faster on a Mac. Trigger from the desktop, the iPhone fulfills, files land in your Mac vault.

Desktop-only vaults

If your Obsidian vault lives only on the Mac (no iCloud), this is the cleanest path.

Scheduled desktop exports

Use the Mac app's scheduling so exports happen even when the iPhone is asleep — as long as both devices are on the same network at the scheduled time.

Local network required.

Both devices must be on the same Wi-Fi network. Cellular-only iPhones can't sync to a Mac. The first connection requires iOS's local-network permission prompt — accept it.

Related