Health Access MCP / Questions and answers

Questions and answers

Apple Health and AI, questions and answers

Health Access MCP gives your AI your Apple Watch workouts and daily health data as files in a folder you own, and puts the workouts it writes back on your Watch. It is free and open source. The short answers are below; each links to the page with the detail.

Getting your data to an AI

Is there an MCP server for Apple Health?

Yes. Health Access MCP is a free iPhone app plus a local MCP server. The app writes your Apple Watch workouts and daily health data as JSON into a folder you pick, and npx -y healthaccess-mcp lets Claude, Cursor or any other MCP client read that folder. It is in the official MCP registry as com.healthaccessmcp/healthaccess-mcp.

How do I give Claude access to my Apple Watch workouts?

Install the app, pick a folder that syncs to your computer, and register the server once. In Claude Code that is one command, claude mcp add --scope user healthaccess -- npx -y healthaccess-mcp; in Claude Desktop it is seven lines in the config file. You can also paste the message the app copies for you (Export, Your AI, Copy) into Claude and it sets itself up. Claude Code, Claude Desktop.

How do I export Apple Health data as JSON automatically?

The app does it after every workout, in the background, with no shortcut to run and no export button to press. You get one file per workout and one file per day, in a folder that keeps itself current. Apple only lets apps read Health while the iPhone is unlocked, so a workout finished with the phone in a bag is written at the next unlock. What the files look like.

Can ChatGPT read my Apple Health data?

Yes, as text or files, not through the MCP server. Copy the message from the app (Export, Your AI, Copy) and paste it into ChatGPT: it carries your summary of the last four weeks. ChatGPT cannot start a program on your computer, so it cannot run a local MCP server. What works with ChatGPT today.

Does it work with Cursor, Codex, LM Studio or Ollama?

Yes, with any client that can launch a local MCP server over stdio. Cursor, Codex CLI, LM Studio and Goose have their config on these pages. Ollama does not launch MCP servers itself, so there you give the model the files or the output of the healthaccess command line. Cursor, local models.

Do I need a Mac?

No. The server has prebuilt binaries for macOS, Linux and Windows. The one rule is that the computer where your AI runs can see the folder the phone writes, for example through iCloud Drive, Dropbox, Google Drive, OneDrive or a NAS. With no computer at all, the message the app copies carries your summary into any AI chat on the phone.

What does my AI get to see?

Every workout with heart rate every few seconds, every interval with its name, and for swims every length with stroke and SWOLF. Per day: sleep with its stages, resting heart rate, HRV, VO2max, steps, rings, weight and every other Health group that has data. A one-page briefing.md sums up the last four weeks. The folder layout.

How far back does the data go?

As far back as Apple Health does. The first sync writes the last 60 days, and Settings, Older data in the app imports 12 months, 3 years or everything.

Training with an AI

Can an AI write a workout and put it on my Apple Watch?

Yes. The AI writes a plan, and the app turns it into a custom workout on your Watch, with the step names on your wrist, at the time the plan says. That takes one tap in the app, or no tap once you switch on "Put new plans on my Watch automatically". Step names need iOS 18. Plans and Put on Watch.

Which sports does it work for?

Reading works for every workout type Apple Health stores. Plans go to the Watch for eleven sports: run, indoor run, walk, hike, cycle, indoor cycle, pool swim, open-water swim, indoor row, HIIT and elliptical. HIIT and elliptical take time goals only.

Can I use Claude as a swim or running coach with my Apple Watch?

Yes, that is what it was built for. The AI reads what you actually did, step by step, with pace and heart rate for each interval, asks you how it felt, and writes the next session onto your Watch. Eleven prompts ship with it, from a weekly check-in to a plan for the week. It never rates a session for you, and questions that point to illness belong with a doctor. Ideas for your AI.

Can I turn a workout from my coach or a training app into an Apple Watch workout?

Yes. Paste or describe the workout and say when you will do it. The AI turns it into a plan the Watch can run: warm-up, the repeated parts, cool-down, each step with a distance or a time, and tells you what it had to change.

Privacy and price

Is there a free alternative to Health Auto Export?

Yes. For getting Apple Health data to an AI, Health Access MCP is one: free, open source under the MIT licence, and it writes your workouts and daily data as JSON into a folder you pick, automatically after every workout. Health Auto Export is a free download whose automatic export belongs to its paid Premium tier (checked on 16 Nov 2026); it offers more formats and destinations. Health Access MCP is the one that also puts the workouts your AI writes back on the Apple Watch. The two side by side.

How can I export Apple Health data for free?

Three ways. Apple's Health app exports everything by hand as one large XML file (your picture, then Export All Health Data). Health Access MCP exports automatically, as one JSON file per workout and per day, free and open source. Other free tools exist too, each with its own trade; the comparison lists them.

Is it free?

Yes. The app is free on the App Store and the server is free and open source under the MIT licence. There is no subscription and no account. The only thing for sale is an optional tip in the app. Health Access on the App Store.

Where does my health data go?

Into the folder you picked, and nowhere else. There is no server and no account, so we cannot see your data. Usage statistics are off until you turn them on, and they never carry a health value. What your AI reads is then covered by that AI's own privacy terms. Privacy in plain words.

Is it open source?

Yes. The app, the MCP server and the command line are on GitHub under the MIT licence, and the npm binaries contain no network code. Source on GitHub.

Limits

Why is my last workout not in the folder yet?

Most likely the phone was locked. Apple only lets apps read Health data while the iPhone is unlocked, so the export waits for the next unlock and then runs on its own. If it still does not arrive, the sync log in the app says why. Support.

Does it work on Android or without an Apple Watch?

There is no Android version; the app needs an iPhone with iOS 17 or later. It exports what is in Apple Health, whichever app or device saved it there. Putting a plan on the wrist needs an Apple Watch.