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
| Setting | Value |
|---|---|
| Endpoint | https://www.fitcoin.co/api/mcp |
| Transport | Streamable HTTP (remote MCP) |
| Auth | OAuth 2.1, authorization code with PKCE and dynamic client registration; or a personal key sent as Authorization: Bearer <key> |
| Access | Read-only. Eleven tools, no writes |
| Rate limit | 240 tool calls a day per connection |
| Personal keys | Up to five per account, each valid for a year, revocable at fitcoin.co/connect |
| Data sources | Apple Health (iPhone), Health Connect (Android), Whoop and Oura APIs, plus Fitcoin's own logs |
| Granularity | Daily 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
| Tool | Returns | Window |
|---|---|---|
get_today | Today's FitScore, steps, SleepScore, Recovery, Energy, Stress, strain, Immune Resilience, HRV and resting heart rate | Today |
get_metric_history | Daily values for one metric, with average, best and worst. Metrics: fitScore, steps, sleepScore, sleepHours, recovery, energy, immune, stress, strain, hrv, restingHeartRate, water | Up to 120 days |
get_workouts | Type, date, minutes, distance, calories, heart rate and source app; optional type filter | Up to 90 days |
get_sleep | SleepScore, hours, stages, HRV, resting heart rate and blood oxygen per night | Up to 30 nights |
get_nutrition | Meals, calories, protein, carbs, fat, fibre, water and targets | Up to 30 days |
get_gym | Lifting sessions with sets, saved routines and best sets | Up to 90 days |
get_check_ins | Mood, water and journal tags | Up to 60 days |
get_cycle | Period dates and cycle-day logs, if the member keeps them | Recent |
get_profile | Name, age, height, weight, streak, league and connected wearables; no contact details | Now |
get_rewards | In-app balance, streak and recent earnings | Recent |
get_challenges | Challenges entered, with status | Current |
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.
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
| Option | How it works | Good for |
|---|---|---|
| Fitcoin | Hosted remote server fed by the Fitcoin phone app | Any client, OAuth or key, free, no server to run |
| VytalLink | Your phone acts as the MCP server for desktop clients | Keeping data on your own devices |
| Health export apps plus your own server | An iPhone app posts Health data to an endpoint you run | Raw samples and full control |
| Open Wearables | Open-source, self-hosted platform with an MCP server | Several wearables, your own infrastructure |
| Claude and ChatGPT built-ins | Read Apple Health inside the phone apps, US only | Chat 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.