Apple Health MCP Server for Cursor, Claude Code and AI Agents

Published November 17, 2026 • By Harris Khan • 8 min read

If you want your own health and fitness data inside Cursor, Claude Code, an agent or a scheduled automation, you need an MCP server for it, and Apple does not make one. This page gives the connection details, a config for each common client, the tools and their limits, and the other options if a hosted server is not what you want.

Disclosure: Fitcoin is our app, and its connector is one of the routes below. We have tried to describe it the way we describe everyone else's, limits included. We have no relationship with Anthropic, OpenAI, Apple, Google, Samsung, Garmin, Whoop, Oura, Strava, COROS or any service named here, and we take no referral fees.

The short answer

Apple does not offer an Apple Health MCP server, or any web API: HealthKit data lives on the iPhone, and Health Connect lives on the Android phone. So every Apple Health MCP server is really an app on your phone plus something that serves the data. Fitcoin's is a hosted, read-only remote MCP server at https://www.fitcoin.co/api/mcp: it reads Apple Health, Health Connect, Whoop and Oura, signs in with OAuth or a personal key, and works in Cursor, Claude Code, VS Code, the Gemini CLI and any agent or automation that speaks remote MCP. It is free.

Connection details

SettingValue
Endpointhttps://www.fitcoin.co/api/mcp
TransportStreamable HTTP (remote MCP)
AuthOAuth 2.1, authorization code with PKCE and dynamic client registration; or a personal key sent as Authorization: Bearer <key>
AccessRead-only. Eleven tools, no writes
Rate limit240 tool calls a day per connection
Personal keysUp to five per account, each valid for a year, revocable at fitcoin.co/connect
Data sourcesApple Health (iPhone), Health Connect (Android), Whoop and Oura APIs, plus Fitcoin's own logs
GranularityDaily values, nights, sessions and logs, not raw sample streams

Get a personal key

Clients that can open a browser, such as Claude Code, VS Code and ChatGPT, can sign in with OAuth and need no key. For everything else, sign in at fitcoin.co/connect, name a key under Personal key and copy it. Fitcoin keeps only a scrambled copy, so it is shown once. Treat it like a password: keep it in your client's config or a secret store, never in a repository.

Cursor

Add this to ~/.cursor/mcp.json (the connect page generates it for you with your key filled in):

{
  "mcpServers": {
    "fitcoin": {
      "url": "https://www.fitcoin.co/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_PERSONAL_KEY" }
    }
  }
}

Claude Code

# Sign in with OAuth (opens a browser):
claude mcp add --transport http fitcoin https://www.fitcoin.co/api/mcp
# then run /mcp inside Claude Code and choose fitcoin

# Or with a personal key:
claude mcp add --transport http fitcoin https://www.fitcoin.co/api/mcp \
  --header "Authorization: Bearer YOUR_PERSONAL_KEY"

VS Code

In .vscode/mcp.json for one workspace, or your user MCP settings. VS Code can also sign in with OAuth if you leave the header out.

{
  "servers": {
    "fitcoin": {
      "type": "http",
      "url": "https://www.fitcoin.co/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_PERSONAL_KEY" }
    }
  }
}

Gemini CLI

In ~/.gemini/settings.json. The Gemini chat app itself does not take custom MCP servers.

{
  "mcpServers": {
    "fitcoin": {
      "httpUrl": "https://www.fitcoin.co/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_PERSONAL_KEY" }
    }
  }
}

Other desktop clients, such as LM Studio and Windsurf, use the same mcpServers shape as Cursor, sometimes with a different name for the URL field. Check the client's MCP docs.

The tools

ToolReturnsWindow
get_todayToday's FitScore, steps, SleepScore, Recovery, Energy, Stress, strain, Immune Resilience, HRV and resting heart rateToday
get_metric_historyDaily values for one metric, with average, best and worst. Metrics: fitScore, steps, sleepScore, sleepHours, recovery, energy, immune, stress, strain, hrv, restingHeartRate, waterUp to 120 days
get_workoutsType, date, minutes, distance, calories, heart rate and source app; optional type filterUp to 90 days
get_sleepSleepScore, hours, stages, HRV, resting heart rate and blood oxygen per nightUp to 30 nights
get_nutritionMeals, calories, protein, carbs, fat, fibre, water and targetsUp to 30 days
get_gymLifting sessions with sets, saved routines and best setsUp to 90 days
get_check_insMood, water and journal tagsUp to 60 days
get_cyclePeriod dates and cycle-day logs, if the member keeps themRecent
get_profileName, age, height, weight, streak, league and connected wearables; no contact detailsNow
get_rewardsIn-app balance, streak and recent earningsRecent
get_challengesChallenges entered, with statusCurrent

Automations and agents

Because it is a standard remote MCP server, anything that can call one can use it with a personal key as a bearer token: n8n's MCP Client Tool node, agent frameworks such as the OpenAI Agents SDK, and the remote-MCP support in Anthropic's and OpenAI's APIs. Some things people build with it:

  • A Monday-morning summary of last week's training, sleep and recovery, sent to email or Slack.
  • A daily check that flags a run of low HRV or rising resting heart rate before a hard session.
  • A journal entry that pulls the day's scores into Obsidian or Notion each evening.
  • A coaching agent that reads your sleep and gym history before suggesting the next session.
Budget your calls. Each connection gets 240 tool calls a day. A scheduled job that asks a few questions is nowhere near that; an agent loop that polls every minute is. Use one key per automation so you can revoke one without breaking the others.

What it will not do

  • Write anything: no logging workouts, editing data or posting.
  • Return raw HealthKit samples, such as every heart-rate reading. It returns daily values, nights, sessions and logs. If you need sample-level data, an export-based route is the better fit.
  • See other members, messages, precise GPS routes, reward codes, payment details, email or phone number.
  • Read data that never reaches Apple Health, Health Connect, Whoop, Oura or Fitcoin.

Other Apple Health MCP options

OptionHow it worksGood for
FitcoinHosted remote server fed by the Fitcoin phone appAny client, OAuth or key, free, no server to run
VytalLinkYour phone acts as the MCP server for desktop clientsKeeping data on your own devices
Health export apps plus your own serverAn iPhone app posts Health data to an endpoint you runRaw samples and full control
Open WearablesOpen-source, self-hosted platform with an MCP serverSeveral wearables, your own infrastructure
Claude and ChatGPT built-insRead Apple Health inside the phone apps, US onlyChat on a phone; not usable from Cursor or agents

For the consumer side of the same question, see Apple Health to Claude and every fitness MCP server compared.

Method: Checked November 17, 2026. Endpoint, transport, auth, limits, tool names and windows are from Fitcoin's server code. Client config formats are from Cursor's, Anthropic's, Microsoft's and Google's MCP documentation and change from time to time; if a field name is rejected, check the client's current docs.

Frequently asked questions

Is there an official Apple Health MCP server?

No. Apple offers no web API for Health data, which stays on the iPhone. Every Apple Health MCP server relies on an iPhone app that reads HealthKit; Fitcoin's is a hosted one that is free and read-only.

Can Cursor read my Apple Health data?

Yes, through a remote MCP server. Add Fitcoin's URL with a personal key to ~/.cursor/mcp.json and Cursor can read your scores, sleep, workouts and more.

Is there a Health Connect MCP server?

Fitcoin's reads Health Connect on Android through the same endpoint, so Samsung, Pixel, Fitbit and Garmin data that reaches Health Connect is available to any MCP client.

Can I use it in n8n or another automation tool?

Yes, if the tool can call a remote MCP server. Use the endpoint with a personal key as a bearer token, and keep within 240 tool calls a day per key.

Does it return raw heart-rate samples?

No. It returns daily values, nights, sessions and logs. For sample-level data, an export app that posts to your own server is the better route.

Is it free?

Yes. The Fitcoin app and the connector are free. Personal keys last a year and you can have five.

Related reading: Fitness apps with MCP connectors, Health data to Claude, Health data to ChatGPT, Create a personal key


About the author: Harris Khan is the co-founder and CTO of Fitcoin, a UK fitness-rewards and health-insights app that reads Apple Health and Health Connect.