Support

1. Where is my export?

It is wherever you pointed it during setup; nothing is preselected and nothing is exported until you choose.

• iCloud Drive: in the Files app under iCloud Drive › MetricBridge. On a Mac the same folder is ~/Library/Mobile Documents/iCloud~ai~healthexport~app/Documents, and the MCP server finds it there by itself. Give iCloud a minute to sync after an export; the in-app History shows the last delivery and whether it succeeded.
• A folder you picked: that folder, in the Files app. If iCloud Drive is off, the file is kept under On My iPhone › MetricBridge.
• Your Wi-Fi or a webhook: on the device you set up to receive it. Settings › Test connection checks the endpoint and the token.

The file is .health-cache.json; CSV and the report PDFs are made from it. Webhook and LAN setup.

2. Ask says it has no data, or not enough history

• Permission. Ask reads Apple Health directly. If a metric was not allowed when iOS asked, Ask cannot see it: Health app › Sharing › Apps › MetricBridge, turn the category on, then ask again.
• Not enough history. A trend needs days to compare. Ask tells you how many days it found and how many it needed; the data card under every answer shows the metric, the date range and the sample count it used. A new Apple Watch or a new iPhone often means a short history for a week or two.
• The question is outside what it can work out. Ask answers about your own data and how it deviates from your baseline. It declines symptom and diagnosis questions on purpose; that is wellness information, not medical advice, and the answer says so.
• Your agent, not Ask, shows no data. That is the export, not Ask: see question 1, then check that the MCP server points at the same folder (npx -y health-export-mcp --doctor prints what it found).

3. Pairing my agent

Pairing is optional. With it on, your agent reads your export only after you give it the pairing code from the app: Settings › Pair your agent shows a QR code and the code as text. Paste it into the MetricBridge extension's setup, or scan the QR. The MCP server refuses requests without it. To revoke an agent, regenerate the code in the same screen: the old code stops working at once. Setup for Claude Desktop, Claude Code, Cursor, VS Code and the rest is on the MCP server page; an agent can also set itself up from /SKILL.md.

4. I want a refund

Purchases go through Apple, so refunds do too: open reportaproblem.apple.com, sign in with the Apple Account you bought with, find MetricBridge and choose "Request a refund". Apple decides and pays it; we cannot issue refunds ourselves and cannot see your request. If you had a problem that made you ask, tell us too: it helps us fix it. There is no subscription to cancel, nothing renews, and the 7-day trial never charges you. Trial and purchase terms.

5. "Apple Intelligence not available"

Apple's on-device model needs an iPhone 15 Pro, iPhone 16 or later on iOS 26 or later, with Apple Intelligence turned on in Settings and a supported language. On any other iPhone (iOS 17 or later) Ask still works in Guided mode: the same numbers, computed the same way, with a shorter write-up. For fuller sentences you can download the optional on-device model (a file of about 400 MB, Wi-Fi only) from Settings; it also runs entirely on the phone and can be removed any time. How the modes compare, and what each needs.

1. Install the app and allow Apple Health (read-only). Pick a destination and tap Export now.

2. Connect your agent. npx -y health-export-mcp in your MCP client, or install the extension bundle. On a Mac it finds the iCloud folder by itself. Then pair it with the code from Settings. Full setup.