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 build- Set 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.
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 files - Keep 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
