Apple Health MCP Server

What the-momentum/apple-health-mcp-server MCP server does

The the-momentum/apple-health-mcp-server MCP server connects an MCP-compatible LLM to data exported from Apple Health. It is designed for exploration and analysis rather than direct synchronization with the Apple Health app. The repository notes that the project has evolved into Open Wearables, which adds continuous Apple Health syncing and support for wearable data from multiple devices; this server remains focused on exported Apple Health data.

The server can help an agent inspect which data types are present, search health records, filter results, extract records by type, and produce statistics or trend analyses. Example uses include reviewing recent activity, summarizing running workouts across selected months, and checking how much data is available for each category.

How it works

Apple Health data is exported from an Apple device and then imported and parsed by the application. The resulting records can be used through MCP tools, allowing an LLM to translate natural-language questions into data exploration actions without requiring the user to write SQL or understand the export structure.

The project describes support for Elasticsearch, ClickHouse, and DuckDB as storage or indexing options for searching health data. It is built with the FastMCP framework and can also be deployed with Docker. The repository presents the importer as a base that can be extended for additional data handling.

Setup and configuration

The repository provides separate documentation for getting started, configuration, architecture, and MCP tools. Configuration is described as .env-based and includes extensive options, but the supplied material does not list the individual variable names or provide a verified server launch command.

Use an Apple Health export as the source data. The README does not specify an export directory, a required database choice, or a complete configuration example, so those details should be taken from the project’s setup and configuration documentation before deployment.

Tools and capabilities

The the-momentum/apple-health-mcp-server MCP server supports capabilities in several areas:

• Inspect the structure and available types in imported Apple Health data.
• Search health records using natural-language requests and filtering parameters.
• Extract records for a selected health-data type.
• Generate data summaries, statistics, and trend analyses.
• Index and query data through Elasticsearch, ClickHouse, or DuckDB integrations.
• Run the application in a Docker-based deployment.

These capabilities make the server suitable for personal activity reviews, comparisons across time periods, and exploratory analysis of exported health records. Results depend on the contents and coverage of the Apple Health export provided to the server.

Limitations and notes

The server works with exported data rather than a live Apple Health connection. Manual export and import are therefore part of the workflow described by the repository. The project’s README states that development has moved toward Open Wearables, whose companion app is intended to remove the need for manual XML exports and provide continuous Apple Health synchronization.

The provided material does not document clinical validation, medical decision support, or guarantees about the accuracy or completeness of generated insights. Treat analyses as data exploration and verify important conclusions against the underlying records. Database selection, environment variables, exact tool names, and deployment commands require consultation of the linked project documentation.