# Health Access MCP

> Health Access MCP is an open-source MCP server for health and science. Read Apple Watch workouts and vitals from local files, and send AI-written plans back. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** iOS, CLI, macOS, self-hosted
- **Website:** https://healthaccessmcp.com
- **MCP Registry name:** com.healthaccessmcp/healthaccess-mcp
- **Categories:** health and science
- **Listing updated:** 2026-11-14

## About

Apple does not let a desktop AI read Watch data, so this works through a companion iOS app that writes each finished workout and daily vitals as JSON into a folder you choose, such as iCloud Drive, Dropbox or a NAS. The MCP server runs on your computer with npx, finds that folder on its own and reads it over stdio. There is no account and no server; the app's settings screen shows what left the phone, which stays empty.

For each session the files include distance, time, heart rate every few seconds, intervals with names and, for swims, strokes and SWOLF. The AI can list and open workouts, read resting heart rate, HRV, sleep, weight, steps and VO2max, and get weekly summaries. It can also write a training plan: it is validated, saved to a plans folder, appears in the app and goes onto the Watch with one tap or automatically, with step labels shown on the wrist on iOS 18.

The site lists limits that come from Apple: data exports only while the phone is unlocked, and pool length cannot be set by a plan. It needs Node.js 18 or newer. The server and command line are MIT licensed. ChatGPT works through the files, not the MCP, since this server uses stdio.

## Features

- **Local file export:** Writes workouts and vitals as JSON into a folder you pick.
- **Workout detail:** Returns intervals, pace, heart rate, zone time and lengths for a session.
- **Vitals and trends:** Reads resting heart rate, HRV, sleep, weight, steps, VO2max and weekly summaries.
- **Plans to the Watch:** push_plan validates a session and sends it to the Watch via the app.
- **Effort ratings:** Stores an effort score you tell the AI, never guessed.
- **Briefing file:** A one-page briefing.md works with any AI that can read a file.

## Good for

- Ask for a weekly check-in on training volume
- Explain your last swim session
- Check whether you are overdoing it from effort and heart rate
- Have an AI plan your next session and put it on the Watch
- Prepare a summary for a coach or doctor

## Install

### Claude Code (Terminal)

```sh
claude mcp add healthaccess-mcp -- npx -y healthaccess-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "healthaccess-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "healthaccess-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "healthaccess-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "healthaccess-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "healthaccess-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "healthaccess-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "healthaccess-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "healthaccess-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "healthaccess-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "healthaccess-mcp"
      ]
    }
  }
}
```

## Tools

- `list_workouts`: Compact rows of sessions, newest first.
- `get_workout`: One session in full with intervals, pace, heart rate and lengths.
- `get_vitals`: Resting heart rate, HRV, sleep, weight, steps and VO2max by day.
- `training_summary`: Weekly volume, sessions, easy-zone share, effort and cardiac cost trend.
- `rate_workout`: Stores the effort rating you give.
- `push_plan`: Validates and writes a workout plan for the Watch.
- `get_plan_status`: Shows whether a plan reached the Watch.
- `list_plans`: Lists plans and their states.

## FAQ

### Does it need an account?

No. There is no account and no server; data stays in the folder you pick.

### Does it work with ChatGPT?

Through the files, yes; through the MCP not today, because it uses stdio.

### What are the Apple limits?

Health data can be read only while the phone is unlocked, and plans cannot set the pool length.

### What is the licence?

The page says the server and command line are MIT.

### Is Health Access MCP free?

Yes. Health Access MCP is open source, so you can use and self-host it for free.

### How do I add Health Access MCP to Claude Code?

Run this command in your terminal: claude mcp add healthaccess-mcp -- npx -y healthaccess-mcp

### What are the best alternatives to Health Access MCP?

The closest alternatives to Health Access MCP are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/health-access-mcp
