Mac App Overview
The Mac app is your central hub for importing Apple Health XML, reviewing charts, running AI analysis, and exposing a local API for OpenClaw and your own tools.
All processing happens locally on your Mac. Your health data stays on your device unless you explicitly choose to send it to an AI provider.
Key Features
Multi-Format Import
Import Apple Health XML and open synced exports from the Mac Sync tab.
AI Analysis
Analyze data with OpenAI, Anthropic, OpenRouter, Ollama, or LM Studio.
Local API
Read-only API on port 8765 for scripts, automations, and integrations.
OpenClaw
Natural language health queries and daily briefs powered by OpenClaw.
Sync Import
Download the latest synced export from the dedicated Mac Sync tab.
Menu Bar Status
Always-visible menu bar indicator for sync status and quick actions.
System Requirements
- macOS 13 Ventura or later
- Apple silicon (M1 or later) or Intel Mac
- An Apple Health XML export, or the iPhone app configured for sync
Installation
Download the Mac app from the App Store. Open it and you are ready to import your first health data export.
App Sections
New
Import a fresh Apple Health XML file and start a new analysis.
Sync
The Mac sync workflow lives in the dedicated Sync tab. Use it to review available exports, refresh the list, and download the latest XML export into analysis.
Previous
Reopen saved analyses and reuse one as the active dataset for integrations when needed.
Results and AI Analysis
Once a dataset is open, review charts and summaries, then run AI analysis using OpenAI, Anthropic, OpenRouter, Ollama, or LM Studio.
All charts share one time selection. Pick Day, Week, Month, Quarter, or Year on any chart and every chart follows. Once you choose a timeframe other than All, a navigation row appears so you can step through periods with the ‹ and › arrows, and a Latest button jumps you back to your newest data.
Some charts need a minimum amount of history before they render — 14 days for heart rate, HRV, and sleep, and 28 days for steps and distance. Below that, the chart shows an "insufficient data" notice instead.
Settings
Manage AI providers, local API settings, and display preferences. Settings also controls how daily numbers are calculated:
- Day Boundary Time Zone — choose whether each day is counted using your current time zone or UTC. This applies to every metric, so your daily totals line up with how you expect days to break.
- Sleep Attribution — count a night's sleep toward the day you woke up or the day you went to bed.
- Weight unit — display weight in kilograms or pounds.
The Mac app does not use Settings as the main sync-management surface.
Getting Data into the Mac App
Use one of these Mac-side paths:
| Method | How It Works | Best For |
|---|---|---|
| Mac Sync tab | Pull the latest XML export from your configured iPhone sync workflow | Regular ongoing updates |
| AirDrop | Export from the iPhone app, then AirDrop the file to your Mac | One-time transfers, full exports |
| File Import | Drag and drop an Apple Health XML export into the Mac app | Files from email, cloud storage, or other sources |
For the smoothest ongoing experience, set up sync on iPhone and use the Mac Sync tab to pull the latest export when you want to analyze it.