How to Connect Apple Health to Cursor IDE & Windsurf via MCP
Published October 8, 2026 · 6 min read · Cursor & Windsurf Playbook
To give Cursor IDE or Windsurf real-time access to your Apple Watch biometrics (sleep, HRV, recovery, workouts), configure the Vaultbeat local MCP server.
Pair your iPhone once with uvx vaultbeat-apple-health@latest bind, then add the server to Cursor's MCP settings using command uvx and args["vaultbeat-apple-health@latest", "serve", "--transport", "stdio"]. Cursor Composer can then invoke health tools during your workflow to evaluate physiological recovery.
Why Connect Apple Watch Biometrics to Your Code Editor?
Modern software engineering is an endurance discipline. When you are deep into a 14-hour refactoring sprint or pushing an urgent hotfix at midnight, your physiological readiness dictates code quality far more than syntax fluency:
Cognitive Readiness Self-Check
If your Apple Watch recorded only 32 minutes of deep sleep and your overnight HRV is down 25% from your 30-day baseline, you should avoid writing irreversible production database migrations. You can ask Cursor Composer to evaluate your biological baseline before approving high-complexity refactors.
Statistical Correlation, Not Guesses
Instead of vague LLM hallucinations, Vaultbeat provides native analytical tools like correlate_metric_series and compare_metric_periods. Your IDE agent can calculate the exact statistical correlation between workout calories and deep sleep hours.
Two-Way Health Journaling
Vaultbeat is not a read-only data dump. With tools like log_symptom and log_note_append, Cursor Composer can record developer ergonomic strains (wrist pain, tension headaches) directly back into your private health vault.
Sub-Daily Intraday Resolution
Inspect high-frequency daytime HRV distributions with get_intraday("hrv_sdnn") to evaluate physiological recovery variance across demanding work days.
Step-by-Step Cursor IDE MCP Configuration
Step 1: Install Vaultbeat on iPhone
Install Vaultbeat on the App Store. Enable HealthKit sync for Sleep, Heart Rate, HRV, Workouts, and Vitals. The app generates an on-device Curve25519 keypair. Local recording on the phone is free forever.
Step 2: Bind Your Development Machine
Ensure you have uv installed (brew install uv). In your Mac terminal, execute the binding command:
uvx vaultbeat-apple-health@latest bind
Scan the terminal QR code with the Vaultbeat iOS app under the MCP tab at the bottom. Your public encryption keys are exchanged securely without routing unencrypted secrets through any cloud server.
Step 3: Add Vaultbeat to Cursor IDE Settings
Open Cursor. Go to Settings → Features → MCP. Click + Add New MCP Server:
- Name:
vaultbeat-health - Type:
command(stdio) - Command:
uvx vaultbeat-apple-health@latest serve --transport stdio
Alternatively, if you use project-level or global .cursor/mcp.json, paste this snippet:
{
"mcpServers": {
"vaultbeat-health": {
"command": "uvx",
"args": [
"vaultbeat-apple-health@latest",
"serve",
"--transport",
"stdio"
]
}
}
}Pricing note: Local recording on iPhone is completely free. Cloud relay and MCP history access require a Pro membership ($9.99/mo, $29.99/yr, or $74.99 lifetime; includes 3-day trial and covers both partners).
Real Developer Scenarios to Try in Cursor Composer
With the MCP server connected, you can query your health context directly inside Cursor Composer prompts:
"Call get_sleep_nights for last night and inspect my deep sleep ratio against my 30-day baseline via get_metric_trend('sleep_deep_hours', days=30). Am I well-rested enough to tackle a high-risk concurrency refactor today, or should I stick to low-risk bug fixes?"
"Compare my HRV from this release week against last week using compare_metric_periods('heart_rate_variability_sdnn', days=7). Run correlate_metric_series('active_energy_burned', 'sleep_deep_hours', days=30) to check whether my training load is impacting deep sleep."
"I have developed a moderate tension headache after 4 hours of intense debugging. Log a symptom episode using log_symptom(symptom_type='headache', severity='moderate', triggers=['screen_fatigue']), and append a note about taking a 20-minute break."
"Query my intraday HRV distribution for today using get_intraday('hrv_sdnn'). How did my physiological recovery vary throughout the work day?"
Zero-Knowledge Privacy: Built for Engineers
Developers care about boundaries: your proprietary codebase stays in Cursor, and your sensitive health biometrics must never leak to third-party ad networks or unencrypted cloud databases.
- On-device sealing: Every metric is encrypted on your iPhone with Curve25519 ECDH + AES-GCM before transport.
- Local decryption: Decryption happens strictly in your local terminal process. Cloud relays only ever route ciphertext blobs.
- No clock-inferred hallucinations: Vaultbeat only passes verified HealthKit observation timestamps. It never fabricates sleep states from the system clock.
- Open source: Inspect and audit the local daemon code on GitHub.
Frequently Asked Questions
Can Cursor IDE connect to Apple Health using MCP?
Yes. Cursor IDE supports the Model Context Protocol (MCP). By installing the Vaultbeat iOS app and adding the open-source vaultbeat-apple-health server to Cursor settings or .cursor/mcp.json, Cursor can query your live sleep, HRV, and recovery biometrics directly inside Composer.
What MCP configuration is required for Cursor IDE?
In Cursor Settings → Features → MCP (or .cursor/mcp.json), add a stdio server with command "uvx" and args ["vaultbeat-apple-health@latest", "serve", "--transport", "stdio"].
Is my health data visible to Cursor or Anthropic servers?
Vaultbeat decrypts all health records strictly on your local machine using Curve25519 ECDH + AES-GCM. Cursor only receives the specific numeric results of the tools it invokes (e.g., last night sleep stages or HRV average) as context in your prompt.