Apple Health MCP Server
Apple Health Data Exploration
[](mailto:hello@themomentum.ai?subject=Apple%20Health%20MCP%20Server%20Inquiry)
[](https://themomentum.ai)
[](LICENSE)
> [!NOTE]
> **This project has evolved into [Open Wearables](https://github.com/the-momentum/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](https://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](docs/getting-started.md)**
## π 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](docs/getting-started.md)** - Complete setup guide
- **[π About](docs/about.md)** - Detailed description & architecture
- **[π§ Configuration](docs/configuration.md)** - Environment variables and settings
- **[π οΈ MCP Tools](docs/mcp-tools.md)** - All available tools
- **[πΊοΈ Roadmap](docs/roadmap.md)** - 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](https://github.com/the-momentum/apple-health-mcp-server/discussions)! You'll also find interesting use cases, tips, and community insights there.
## π₯ Contributors