Apple Health Mcp Server
@the-momentum
About Apple Health Mcp Server
Apple Health MCP Server is a Model Context Protocol tool that enables AI agents like Claude to seamlessly analyze Apple Health data. The server provides comprehensive tools for searching, filtering, and analyzing health data using natural language queries, without requiring knowl
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"uv-mcp-server": {
"command": "uv",
"args": [
"run",
"--frozen",
"--directory",
"<project-path>",
"start"
],
"env": {
"PATH": "<path-to-uv-bin-folder>"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Apple Health Mcp Server?
A Model Context Protocol (MCP) server designed for interaction between LLM-based agents and Apple Health data. It provides a standardized interface for querying, analyzing, and managing health records imported from XML exports and indexed in Elasticsearch, accessible from MCP-compatible clients like Claude Desktop.
How to use Apple Health Mcp Server?
Export Apple Health data as an XML file, clone the repository, set environment variables in config/.env, and run make es to start Elasticsearch and import the data. Configure the server in your MCP client using either Docker (mcp-server:latest with appropriate mounts) or local uv run start with the correct binary path, then restart the client.
Key features of Apple Health Mcp Server
- Built on the FastMCP framework for high-performance MCP server capabilities
- Imports, parses, and analyzes Apple Health XML exports
- Powerful search and filtering using natural language and advanced parameters
- Elasticsearch integration for scalable indexing and querying
- Modular tools for structure analysis, record search, type extraction, and statistics
- Container-ready with Docker support for easy deployment
Use cases of Apple Health Mcp Server
- Analyze available health data types and their volume from an XML export
- Query daily, weekly, or monthly activity statistics using natural language
- Search and filter specific health records by type, device, or attribute value
- Summarize and compare workout trends across different time periods
- Generate trend analyses for a health record type over daily, weekly, monthly, or yearly aggregations
FAQ from Apple Health Mcp Server
What is this server and how does it differ from directly querying Apple Health?
It provides an MCP interface for LLM agents to interact with Apple Health data without requiring knowledge of XML or Elasticsearch query languages. Data is indexed in Elasticsearch for fast, scalable search and aggregation.
What are the runtime requirements and dependencies?
Requires Docker (recommended) or uv with Docker, an Apple Health XML export, and an Elasticsearch instance running locally. Environment variables are configured via a .env file.
Where is my health data stored and processed?
Data is extracted from the Apple Health XML export file and indexed into a local Elasticsearch instance. The server itself runs locally and does not send data to external services by default.
What transport and authentication mechanisms are supported?
The server uses the Model Context Protocol (MCP) for communication. Authentication is configured via environment variables for Elasticsearch (ES_USER, ES_PASSWORD), and the server is intended for local use with a personal MCP client.
Are there any known limitations?
XML tools are still being optimized for performance, and more advanced Elasticsearch analytics features are planned. Large XML exports may require significant system resources during import.
Frequently asked questions
What is this server and how does it differ from directly querying Apple Health?
It provides an MCP interface for LLM agents to interact with Apple Health data without requiring knowledge of XML or Elasticsearch query languages. Data is indexed in Elasticsearch for fast, scalable search and aggregation.
What are the runtime requirements and dependencies?
Requires Docker (recommended) or uv with Docker, an Apple Health XML export, and an Elasticsearch instance running locally. Environment variables are configured via a `.env` file.
Where is my health data stored and processed?
Data is extracted from the Apple Health XML export file and indexed into a local Elasticsearch instance. The server itself runs locally and does not send data to external services by default.
What transport and authentication mechanisms are supported?
The server uses the Model Context Protocol (MCP) for communication. Authentication is configured via environment variables for Elasticsearch (ES_USER, ES_PASSWORD), and the server is intended for local use with a personal MCP client.
Are there any known limitations?
XML tools are still being optimized for performance, and more advanced Elasticsearch analytics features are planned. Large XML exports may require significant system resources during import.
Basic information
More Other MCP servers
Mobile Mcp
mobile-nextModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Comments