Apple Health Chat MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Apple Health Chat MCP How active was I yesterday?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Apple Health Chat MCP
Ask Claude natural language questions about your Apple Health data! This MCP server enables conversational analysis of your health metrics from iOS Health Export CSV files.
Example questions you can ask:
"How active was I yesterday?"
"Did I get enough sleep this week?"
"What's my step count trend?"
"Was my heart rate higher than usual today?"
Quick Start
Install & Build:
npm install && npm run buildSet up your health data:
export HEALTH_EXPORT_DIR="/path/to/your/health/export/files"Configure Claude Desktop:
{ "mcpServers": { "apple-health-chat": { "command": "node", "args": ["/path/to/apple-health-chat-mcp/dist/index.js"], "env": { "HEALTH_EXPORT_DIR": "/path/to/your/health/files" } } } }Start asking questions! Restart Claude Desktop and chat about your health data.
Related MCP server: Apple Health MCP
Features
Natural Language Queries: Ask questions in plain English
Comprehensive Metrics: Steps, heart rate, sleep, energy, and more
Flexible Time Periods: Today, yesterday, last week, custom ranges
Local Processing: CSV files stay on your device
Privacy Transparent: Query results sent to Claude (not raw data)
Supported Health Metrics
Automatically detects metrics from your Health Export files:
Step Count, Heart Rate (Min/Max/Avg)
Sleep Analysis, Active Energy
And many more from your iOS Health app
Privacy & Data Flow
Your CSV files: Stored and processed locally on your device
When you ask Claude: Query results (like "8,500 steps") are sent to Claude for analysis
Raw health data: Never leaves your device
Get Your Health Data
Use the iOS Health Export app to export your data
Set
HEALTH_EXPORT_DIRto point to your CSV filesKeep personal data out of version control (see
.gitignore)
Development
npm run dev # Development mode
npm test # Run tests
npm run lint # Lint codeLicense
MIT
Support
Issues - Report bugs or request features
Made with ❤️ for health-conscious people who want to chat with their data
Available Tools
6 toolshealth_export_askA
Ask any natural language question about your health data. The LLM will interpret the question and query the appropriate metrics.
Inputs: question (required), date.
health_export_get_metricsA
Get raw health metrics data for a specific date range. Use this when you need to analyze specific metrics or perform custom calculations.
Inputs: end_date (required), start_date (required), metrics.
health_export_metricsC
Get specific metric data with optional filtering and aggregation
Inputs: metric_name (required), end_date, start_date, aggregation.
health_export_queryB
Execute SQL-like queries on health data from Health Export CSV files
Inputs: query (required), format.
health_export_reportC
Generate structured health reports for specific time periods
Inputs: report_type (required), end_date, start_date, include_metrics.
health_export_schemaA
Get available metrics, date ranges, and sample data from health export files
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Multiple tools have overlapping purposes: health_export_metrics and health_export_get_metrics both retrieve metric data with filtering, and health_export_query can also be used for similar queries. health_export_ask is a catch-all natural language interface that may subsume the others, creating confusion about which tool to select.
All tools share the 'health_export_' prefix, but the suffixes mix verb forms (query, report, ask, get_metrics) with noun forms (schema, metrics). The similar names 'health_export_metrics' and 'health_export_get_metrics' further reduce consistency.
With 6 tools, the server is well-scoped for querying and analyzing Apple Health export data. Each tool has a place in the workflow, and the count is within the ideal range for a domain-specific server.
The server covers schema discovery, raw data retrieval, aggregated metrics, reports, and natural language queries, providing a solid read-only query surface. Minor gaps exist, such as no explicit way to list all available export files, but these are not critical for the core purpose.
Maintenance
Related MCP Connectors
Ask Claude, ChatGPT or Cursor about your Apple Health data: workouts, sleep, food. Read-only.
Apple Health training load, recovery, HRV and workout detail for Claude, ChatGPT and any MCP client.
Hosted Apple Health MCP: workouts, sleep and HRV in ChatGPT, Claude, Gemini, Grok. Free, no export.
Your Apple Health data, food diary and lifts, for ChatGPT, Claude and Gemini. Approved on iPhone.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables Claude Desktop to access and analyze Garmin wearable health data including sleep, HRV, Body Battery, and activity metrics. Users can query their health trends, track recovery, and generate interactive HTML dashboards using natural language.97MIT
- AlicenseBqualityDmaintenanceEnables users to query Apple Health metrics, workouts, and trends from CSV files exported via the Health Auto Export app. It allows MCP clients to analyze health data such as heart rate, sleep stages, and activity levels directly from local iCloud Drive storage.39 npm2MIT
- FlicenseBqualityDmaintenanceEnables Claude to directly access, query, and analyze local CSV files using natural language, keeping data private and local.41-
- AlicenseAqualityDmaintenanceProvides Claude with real-time access to local health data including sleep, recovery, strain, and workouts from WHOOP and Apple Health, enabling informed context-aware interactions.61MIT