Apple Health data for your AI assistant, without uploading it

Two ways to ask questions about your own health data: paste a compact Markdown summary into any chat, or let an assistant you already run query Healthcove directly through a local MCP server. Healthcove contains no AI and never contacts one.

On this page

Markdown export and Copy for AI (free)
The local MCP server (Pro)
Set up on your Mac
Set up on your iPhone
What the assistant can ask for
What leaves your devices

Markdown export and Copy for AI (free)

The Markdown format is a plain-text summary sized to paste into a chat: per-metric statistics and daily values in your display units, for the types and date range you choose. It also reads well in Obsidian or any notes app.

Open the Export tab and set the format to Markdown (AI-ready).
Pick the data types and a date range. A month or a quarter keeps the text small enough for any chat window.
Tap Copy for AI to put the summary on the clipboard, or Export & Share to save a .md file.
Paste it into your assistant and ask.

Questions that work well: "What changed in my sleep after the first week of September?", "Is there a pattern between my resting heart rate and the days I exercised?", "Summarise this for my doctor in five lines." The assistant only knows what you pasted, so narrow the range to the question.

The local MCP server (Pro)

The Model Context Protocol (MCP) is the standard way desktop assistants connect to data sources. Healthcove ships an MCP server, so an assistant you already run, such as Claude Desktop, Claude Code, Cursor or any other MCP client, can query your health data itself instead of you pasting summaries. The server runs on your Mac or iPhone, serves only the client you connect, and stops when you turn it off.

Set up on your Mac

The Mac server reads the data already synced from your iPhone, so it works while the phone is away. Pair and sync first if you haven't: see the Mac guide.

In the Mac app open Settings → AI Assistants and turn the server on.
Copy the snippet for your client. The server is an executable inside the app bundle, so no port, certificate or extra install is involved.
Use Test to confirm the server can read the synced data.

# Claude Code
claude mcp add healthcove -- "/Applications/Healthcove.app/Contents/MacOS/healthcove-mcp"

# Claude Desktop (claude_desktop_config.json) or Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "healthcove": {
      "command": "/Applications/Healthcove.app/Contents/MacOS/healthcove-mcp"
    }
  }
}

Restart the client after adding the server, then ask it about your health data.

Set up on your iPhone

The iPhone serves live HealthKit data over your local network from the same TLS server that syncs to your Mac.

Open Settings → Local API and turn on LAN Sharing.
Create an Access Token. Copy it now; it's shown once. Revoking it later never disconnects a paired Mac.
Note the Base URL shown on that screen. The MCP endpoint is that URL plus /mcp, and the client authenticates with Authorization: Bearer <token>.
The server uses a self-signed certificate. Tap Export Server Certificate (PEM), save healthcove.pem where your client runs, and point the client at it: for Node-based clients such as Claude Code or mcp-remote that is export NODE_EXTRA_CA_CERTS=/path/to/healthcove.pem. The screen shows a ready-made mcp-remote config block for Claude Desktop and Cursor.

Like the rest of the Local API, the iPhone server only runs while LAN Sharing is on and Healthcove is in the foreground. iOS suspends it in the background, so keep the app open while the assistant is querying. For an always-available server, use the Mac.

What the assistant can ask for

Tool	Returns
`get_status`	App version, the unit system values are reported in, the current time, and how many types have data
`list_types`	Every type with data: id, display name, category, unit, and the dates of its earliest and latest samples
`get_samples`	Raw samples for a type and date range, each with its unit
`get_aggregates`	Per-interval statistics: sums for cumulative types like steps and energy, average / min / max for measured types like heart rate and weight
`get_summary`	Every numeric type in the range at a glance: days with data, average, min, max, latest, and totals for cumulative types
`get_workouts`	Workouts oldest first: activity, start, end, duration in minutes, energy in kcal, distance with its unit
`get_sleep`	Sleep sessions and their stages
`compare_periods`	The daily average of a type in two periods, with the absolute and percent change
`correlate`	Pearson correlation between the daily values of two types, with an optional lag in days

Dates are ISO 8601 and units follow your display setting, so the assistant can't mistake a 1 for 1 percent.

What leaves your devices

Markdown and Copy for AI: only what you paste, to whichever service you paste it into. That service's privacy policy applies to it.
MCP on the Mac: nothing leaves the Mac. The client process reads from the server over a local pipe.
MCP on the iPhone: answers go over your Wi-Fi, encrypted, only to clients holding your token.
Healthcove sends nothing to us, ever. Details in the privacy policy.

Ready? Markdown export is free. The MCP server is part of Pro, with a 7-day free trial.

Download for iPhone Get it for Mac