# Open Health Sync

The Open Health Sync MCP server connects to Claude Code and other clients for read-only access to wearable data. Agents can request heart rate, sleep, workouts, nutrition and daily summaries; the server runs on your own host.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 72 repo stars
- Author: soma-intelligence
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/soma-intelligence/open-health-sync
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/open-health-sync

## What it does

Open Health Sync pulls data from eighteen wearable and health sources into one model, then exposes it through a read-only MCP server. An agent can ask for heart rate, sleep, steps, workouts and nutrition without write access. Sources include Apple Health, Withings, Oura, WHOOP, Fitbit, Polar, Strava, Garmin, Dexcom, OMRON and Health Connect.

The project is a single Go binary plus Postgres. It runs on a Raspberry Pi. Besides MCP, the outputs include a REST API, FHIR R4, Open mHealth and CSV/Parquet exports. Version 0.2.0 is an early preview: APIs, config and schema can change in any 0.x release.

It ships as a Docker image `ghcr.io/soma-intelligence/open-health-sync:0.2.0`. Connecting an MCP client requires `OHS_MCP_URL` and `OHS_MCP_KEY` environment variables pointing at a running instance. A hosted beta with the same API exists, so you can skip running a server and get a key in a minute.

## Requirements
- Needs: Docker
- Environment variables: `OHS_MCP_URL`, `OHS_MCP_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env OHS_MCP_URL=<OHS_MCP_URL> --env OHS_MCP_KEY=<OHS_MCP_KEY> --transport stdio open-health-sync -- docker run -i --rm -e OHS_MCP_URL -e OHS_MCP_KEY ghcr.io/soma-intelligence/open-health-sync:0.2.0
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add open-health-sync --env OHS_MCP_URL=<OHS_MCP_URL> --env OHS_MCP_KEY=<OHS_MCP_KEY> -- docker run -i --rm -e OHS_MCP_URL -e OHS_MCP_KEY ghcr.io/soma-intelligence/open-health-sync:0.2.0
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "open-health-sync": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "OHS_MCP_URL",
                "-e",
                "OHS_MCP_KEY",
                "ghcr.io/soma-intelligence/open-health-sync:0.2.0"
            ],
            "env": {
                "OHS_MCP_URL": "<OHS_MCP_URL>",
                "OHS_MCP_KEY": "<OHS_MCP_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "open-health-sync": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "OHS_MCP_URL",
                "-e",
                "OHS_MCP_KEY",
                "ghcr.io/soma-intelligence/open-health-sync:0.2.0"
            ],
            "env": {
                "OHS_MCP_URL": "<OHS_MCP_URL>",
                "OHS_MCP_KEY": "<OHS_MCP_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OHS_MCP_URL=<OHS_MCP_URL> -e OHS_MCP_KEY=<OHS_MCP_KEY> open-health-sync docker run -i --rm -e OHS_MCP_URL -e OHS_MCP_KEY ghcr.io/soma-intelligence/open-health-sync:0.2.0
```
Replace <…> with your own values

## When to use it
- give an AI agent read-only access to wearable data
- merge heart rate, sleep and steps from multiple sources into one model
- export health data to CSV or Parquet for analysis
- run a health API on your own server without third-party services
- get FHIR R4 and Open mHealth output from one binary

## Example prompts
- Show me my average heart rate over the last seven days
- Compare sleep from Oura and WHOOP for the past week
- Export steps for this month to CSV and plot them

## Similar
- [apple-health](https://affpapa.org/en/nevibecode/skills/apple-health.md) — skill · ★ 93 repo stars
- [Polar Health Data (self-hosted)](https://affpapa.org/en/nevibecode/mcp/polar-health-data-self-hosted.md) — MCP server · ★ 26 repo stars
- [whoop](https://affpapa.org/en/nevibecode/mcp/whoop.md) — MCP server · ★ 183 repo stars
- [oura-ring-mcp](https://affpapa.org/en/nevibecode/mcp/oura-ring-mcp.md) — MCP server · ★ 37 repo stars
- [Quantified Self MCP](https://affpapa.org/en/nevibecode/mcp/quantified-self-mcp.md) — MCP server · ★ 8 repo stars
- [oura](https://affpapa.org/en/nevibecode/skills/oura.md) — skill · 818 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
