Apple Health in Cursor

What you need

• An iPhone on iOS 15 or later with Apple Health. Apple Watch data comes along too.
• The HealthAPI app. Free for 2 days, no card needed. Then an optional 7-day free trial when you subscribe. The preview includes 25 requests a day. When the 2 days are up, AI apps and the API stop reading your data until you choose a plan in the app. Your synced data is kept for about 5 weeks, so subscribing picks up where you left off. Pro is $4.99 a month or $49.99 a year (100 requests a day); Developer is $9.99 a month or $99.99 a year (1,000 a day). Cancel anytime in the App Store.
• Cursor on your computer.

Set it up in 4 steps

1. 1

   Install HealthAPI and sync

   Get HealthAPI from the App Store, open it and allow Apple Health. Your history uploads, then new data keeps syncing.
2. 2

   Add the server to Cursor

   Use the Add to Cursor button below, or add healthapi with the URL https://healthapi.app/mcp to ~/.cursor/mcp.json.
3. 3

   Sign in and approve on your iPhone

   When Cursor asks you to sign in, a HealthAPI page opens in your browser with a short code. Scan its QR code with your iPhone, or enter the code in HealthAPI under Connect, check the code matches, and tap Approve.
4. 4

   Ask the agent

   In a Cursor chat, ask something that needs your data, such as “Use HealthAPI to get my last 30 nights of sleep.” Cursor shows each tool call in the chat.

The sign-in page labels Cursor an unverified app, because a program on your own computer can't be checked from outside. If you started the sign-in yourself and the codes match, it's fine to approve. Manage the server later under Customize in Cursor's sidebar, and disconnect it any time in the HealthAPI app under Settings, Connected apps.

The config

The Add to Cursor button writes this for you. To do it by hand, put it in ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:

{
  "mcpServers": {
    "healthapi": {
      "url": "https://healthapi.app/mcp"
    }
  }
}

Rather use your API key than sign in? Send it as a header instead (key in the app under Connect, then Other tools), and keep this version in the global file only:

{
  "mcpServers": {
    "healthapi": {
      "url": "https://healthapi.app/mcp",
      "headers": { "Authorization": "Bearer <your API key>" }
    }
  }
}

What to build with it

• A personal dashboard. “Use HealthAPI to get 90 days of resting heart rate, HRV and sleep, then build a single-page HTML dashboard with a chart for each.”
• An analysis script. “Look at my workouts and sleep for the last 3 months, then write a Python script that checks whether I sleep longer after training days.”
• An app on real data. “Fetch one of my daily summaries and generate TypeScript types and test fixtures from it.”
• Quick questions while you work. “How did I sleep last night?” works here too.

For code that runs on its own later, call the REST API with your key; the Python guide has a starting point.

The tools Cursor sees

Every tool is read only. The MCP server page covers inputs, sign-in and discovery in detail.

Questions