Apple Health holds years of your biometric data — sleep stages, HRV, heart rate, workouts, VO₂ max, and 150+ other metrics. health4.ai makes all of it queryable from Claude, ChatGPT, Cursor, Ollama…
health4ai is an MCP project maintained in the jefflitt1/health4ai repository. The maintainer describes its purpose as “Apple Health holds years of your biometric data — sleep stages, HRV, heart rate, workouts, VO₂ max, and 150+ other metrics. health4.ai makes all of…”. Read the project documentation for the complete scope.
The project provides a local client configuration using python. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares DATABASE_URL, HEALTHKIT_USER_ID. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| never_recorded | this metric has never produced a sample for you. For steps, |
| empty_window | nothing in the window you asked about, but the metric has data at |
| get_health_summary | Overview of key metrics for the past N days |
| get_sleep | Per-night sleep breakdown with REM, Deep, Core stages. One source per night: Oura > Apple Watch > Whoop > Garmin > Withings > whichever other source (iPhone… |
| get_hrv_trend | Daily HRV (SDNN) with rolling comparison and trend |
| get_daily_snapshot | Everything recorded for a specific date |
| get_workouts | Recent workouts with type, duration, distance, calories |
| query_metric | Raw time-series for any HealthKit metric type |
| get_long_term_trend | Monthly aggregates over years (raw + summary tiers) |
| get_coaching_brief | Recovery status, sleep quality (same one-source-per-night rule as get_sleep), training load, fitness markers |
| search_records | Find days where a metric crossed a threshold |
| get_metric_stats | Personal baseline: min/max/mean/percentiles |
| compare_periods | Compare a metric between two date ranges |
{
"mcpServers": {
"health4ai": {
"command": "python",
"args": [
"/path/to/health4ai/mcp-server/main.py"
],
"env": {
"DATABASE_URL": "postgresql://...",
"HEALTHKIT_USER_ID": "<your auth user UID>"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| DATABASE_URL | Declared in the maintainer’s client configuration. | Check documentation |
| HEALTHKIT_USER_ID | Declared in the maintainer’s client configuration. | Check documentation |
Inspect PostgreSQL schemas and run read-only queries with the archived MCP reference server. Review its maintenance status before choosing it.
Connect the Notion MCP server to search workspace content and work with pages and databases through Notion’s hosted OAuth service.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Official MongoDB server covering data, schemas and Atlas management — from find queries to spinning up clusters.