the-momentum/apple-health-mcp-server
🐍 🏠 🍎 🪟 🐧 - An MCP server that provides access to exported data from Apple Health. Data analytics included.
Quick Install
{
"mcpServers": {
"the-momentum-apple-health-mcp-server": {
"command": "npx",
"args": [
"-y",
"the-momentum-apple-health-mcp-server"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
Apple Health MCP Server
Apple Health Data Exploration
[!NOTE] This project has evolved into Open Wearables - self-hosted platform to unify wearable health data from multiple devices, including Apple Health. Open Wearables also provides an MCP server and a companion app for continuous Apple Health data sync, eliminating the need for manual XML exports. Check it out: github.com/the-momentum/open-wearables
Connect your Apple Health data with any LLM that supports MCP. Talk to your data and get personalised insights.
💡 Demo
This demo shows how Claude uses the apple-health-mcp-server to answer questions about your data. Example prompts from the demo:
- I would like you to help me analyze my Apple Health data. Let's start by analyzing the data types - check what data is available and how much of it there is.
- What can you tell me about my activity in the last week? How did my daily statistics look?
- Please also summarise my running workouts in July and June. Do you see anything interesting?
https://github.com/user-attachments/assets/93ddbfb9-6da9-42c1-9872-815abce7e918
Want to try it out? 🚀 Getting Started
🌟 Why to use Apple Health MCP Server?
- 🧩 Fit your data everywhere: using this software you can import data exported from Apple devices into any DBMS, base importer is already prepared for extensions
- 🎯 Simplify complex data access: you don't need to know data structure or use any structured query language, like SQL, simple access is just granted with natural language
- 🔍︎ Find hidden trends: use LLM as a gate to flexible auto-generated queries which will be able to find data trends not so easy to detect manually
✨ Key Features
- 🚀 FastMCP Framework: Built on FastMCP for high-performance MCP server capabilities
- 🍏 Apple Health Data Exploration: Import, parse, and analyze Apple Health XML exports
- 🔎 Powerful Search & Filtering: Query and filter health records using natural language and advanced parameters
- 📦 Elasticsearch, ClickHouse or DuckDB Integration: Index and search health data efficiently at scale
- 🛠️ Modular MCP Tools: Tools for structure analysis, record search, type-based extraction, and more
- 📈 Data Summaries & Trends: Generate statistics and trend analyses from your health data
- 🐳 Container Ready: Docker support for easy deployment and scaling
- 🔧 Configurable: Extensive
.env-based configuration options
📚 Documentation
- 🚀 Getting Started - Complete setup guide
- 🔍 About - Detailed description & architecture
- 🔧 Configuration - Environment variables and settings
- 🛠️ MCP Tools - All available tools
- 🗺️ Roadmap - Upcoming features and roadmap
Need help? Looking for guidance on use cases or implementation? Don't hesitate to ask your question in our GitHub discussion forum! You'll also find interesting use cases, tips, and community insights there.
👥 Contributors
💼 About Momentum
This project is part of Momentum’s open-source ecosystem, where we make healthcare technology more secure, interoperable, and AI-ready. Our goal is to help HealthTech teams adopt standards such as FHIR safely and efficiently. We are healthcare AI development experts, recognized by FT1000, Deloitte Fast 50, and Forbes for building scalable, HIPAA-compliant solutions that power next-generation healthcare innovation.
📖 Want to learn from our experience? Read our insights → themomentum.ai/blog. Interested? Let's talk!
Built with ❤️ by Momentum • Transforming healthcare data management with AI