Skip to content
MCP server

MetricBridge Apple Health

Ask an agent about your own Apple Health data, read from a local export

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, iOS
Runs
Locally
Version
1.11.0
Listing updated
3 days ago

About MetricBridge Apple Health

MetricBridge Apple Health is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

Everything happens on your machine. The MetricBridge iPhone app writes a .health-cache.json file to iCloud Drive, a folder or your LAN, and this npm server reads it. Nothing is sent to the developer or to a cloud AI, and the page says it makes no outbound network requests and has no dependencies.

The server exposes 21 tools over 194 metrics, such as HRV, sleep, resting heart rate, steps, workouts and VO2 max. Nineteen only read; add_event and remove_event write to their own events file, never to Apple Health. Answers carry units, exact date ranges, whether each window was complete and how much history exists. For example, correlate_metrics refuses to run on fewer than ten aligned days and labels results as association, not causation.

On a Mac the iCloud folder is found automatically; elsewhere set HEALTH_DATA_DIR. A demo mode serves synthetic data if you have no iPhone yet. Optional pairing and export-passphrase secrets are supported. The server is MIT-licensed and free; the app is a one-time $24.99 after a 7-day trial.

Install

Run in a terminal

claude mcp add health-export-mcp --env PAIRING_SECRET='<PAIRING_SECRET>' --env HEALTH_EXPORT_PASSPHRASE='<HEALTH_EXPORT_PASSPHRASE>' -- npx -y health-export-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "health-export-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "health-export-mcp"
      ],
      "env": {
        "PAIRING_SECRET": "<PAIRING_SECRET>",
        "HEALTH_EXPORT_PASSPHRASE": "<HEALTH_EXPORT_PASSPHRASE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "health-export-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "health-export-mcp"
      ],
      "env": {
        "PAIRING_SECRET": "<PAIRING_SECRET>",
        "HEALTH_EXPORT_PASSPHRASE": "<HEALTH_EXPORT_PASSPHRASE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "health-export-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "health-export-mcp"
      ],
      "env": {
        "PAIRING_SECRET": "<PAIRING_SECRET>",
        "HEALTH_EXPORT_PASSPHRASE": "<HEALTH_EXPORT_PASSPHRASE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "health-export-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "health-export-mcp"
      ],
      "env": {
        "PAIRING_SECRET": "<PAIRING_SECRET>",
        "HEALTH_EXPORT_PASSPHRASE": "<HEALTH_EXPORT_PASSPHRASE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "health-export-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "health-export-mcp"
      ],
      "env": {
        "PAIRING_SECRET": "<PAIRING_SECRET>",
        "HEALTH_EXPORT_PASSPHRASE": "<HEALTH_EXPORT_PASSPHRASE>"
      }
    }
  }
}

Configuration

  • HEALTH_DATA_DIRFolder holding .health-cache.json from the MetricBridge iOS app. Unset on a Mac, the server reads ~/Library/Mobile Documents/iCloud~ai~healthexport~app/Documents if it exists.
  • PAIRING_SECRETOnly if Agent pairing is on in the iOS app (Settings > Agent pairing).
  • HEALTH_EXPORT_PASSPHRASEOnly if Export encryption is on in the iOS app.
  • HEALTH_DATA_DIRFolder holding .health-cache.json from the MetricBridge iOS app. Unset on a Mac, the server reads ~/Library/Mobile Documents/iCloud~ai~healthexport~app/Documents if it exists.
  • PAIRING_SECRETOnly if Agent pairing is on in the iOS app (Settings > Agent pairing).
  • HEALTH_EXPORT_PASSPHRASEOnly if Export encryption is on in the iOS app.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

get_trends
Compares a metric's recent window with the prior one.
get_mcp_status
Reports the file read, counts and latest data date.
compare_periods
Compares two periods and flags when one is too thin.
correlate_metrics
Correlates two metrics, refusing below ten aligned days.
add_event
Logs an event to the server's own events file.
remove_event
Removes a logged event from that file.

What it does

Wide metric coverage
Reaches 194 Apple Health metrics.
Provenance in every answer
Returns units, date ranges and window completeness.
Trend and period comparison
Compares recent windows against earlier ones.
Correlation with guardrails
Refuses thin data and states association is not causation.
Demo dataset
A flag serves watermarked synthetic data for trying the tools.
Local and read-only
Reads a local file and cannot write to Apple Health.

Good for

  • Compare this week's HRV with last week's
  • Review sleep and resting heart rate trends
  • Log a personal health event for later queries
  • Check whether the export is current

Pricing

Open source

Server MIT and free; MetricBridge app 7-day trial then $24.99 once

Prices change. Check healthexport.dev before you buy.

MetricBridge Apple Health FAQ

Does health data leave my machine?

The server reads a local file and makes no outbound network requests.

What do I need?

The MetricBridge iPhone app for your own data, plus Node.js 18 or later.

Can I try it without an iPhone?

Yes, run it with --demo.

What does it cost?

The server is free under MIT; the app has a 7-day trial then $24.99 once.

Is MetricBridge Apple Health free?

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

How do I add MetricBridge Apple Health to Claude Code?

Run this command in your terminal: claude mcp add health-export-mcp --env PAIRING_SECRET='<PAIRING_SECRET>' --env HEALTH_EXPORT_PASSPHRASE='<HEALTH_EXPORT_PASSPHRASE>' -- npx -y health-export-mcp

What are the best alternatives to MetricBridge Apple Health?

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

Alternatives to MetricBridge Apple Health

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science