apple-health

The Apple Health MCP Server provides a FastMCP-based interface to explore and query Apple Health data exports. It exposes a set of modular MCP tools that let you structure, search, extract types, summarize data, and generate trends from Apple Health XML exports or connected data stores. You can interact with the server using natural language to request data summaries, run targeted searches, or analyze running workouts and activity statistics across date ranges. The server is designed to index and search data efficiently via integrated backends and to be extended with additional MCP tools as your data needs evolve. For practical use, start by loading your Apple Health data, then use the built-in tools to analyze data types, filter by date ranges, and summarize trends. The documentation includes getting started, an overview of the architecture, detailed configuration, and a catalog of available MCP tools to guide you through common tasks.

Prerequisites:

• Docker installed and running on your machine
• Access to a terminal/CLI with permissions to run containers

Step 1: Clone or pull the MCP server repository (if you have a local copy of the server images, skip this).

git clone https://github.com/the-momentum/apple-health-mcp-server.git
cd apple-health-mcp-server

Step 2: Ensure Docker image is available

docker pull the-momentum/apple-health-mcp-server

Step 3: Run the server using Docker

docker run -i the-momentum/apple-health-mcp-server

Step 4: Verify the server is up (depends on image, typically you can check logs or the exposed port)

docker ps

Step 5: Configure environment variables (if needed) The server supports environment-based configuration. Common vars may include database connections, ports, and data paths. Example placeholders:

ENV_VARS:
  PORT: "8080 simple default"
  DATA_STORE: "path_or_connection_string"

Step 6: Optional: Run via other runtimes (if the image provides alternatives)

# If image supports a direct CLI entrypoint, you may run:
docker run -e PORT=8080 -e DATA_STORE=/data apple-health-mcp-server

Tips and common considerations:

• The server is designed to work with Apple Health XML exports and can index/search via backends like Elasticsearch, ClickHouse, or DuckDB depending on configuration.
• Configuration is primarily환경 variable-driven; refer to docs/configuration.md for exact keys and defaults.
• If you plan to run in production, consider mounting persistent storage for data stores and enabling appropriate network security settings.
• When troubleshooting, check container logs for initialization messages, tool loading status, and any parsing errors from Apple Health XML exports.
• The MCP tool-suite includes structure analysis, record search, type-based extraction, data summaries, and trend analyses. Use docs/mcp-tools.md to see all available commands and examples.