Sandbox
@the-momentum/apple-health-mcp-server

MCP server for Apple Health data queries

This server connects Apple Health exports to any MCP-capable agent so you can ask questions in plain language. It parses Apple Health XML, stores or indexes the data with DuckDB, Elasticsearch, or ClickHouse, and exposes tools for searching, summarizing, and analyzing records.

265 stars23 forksPythonUpdated 2mo ago
Who it's for

Builders who want their agent to explore Apple Health data from exported health files.

What it delivers

You can ask questions about your health history in natural language instead of digging through XML or writing queries.

What it does

Apple Health XML import

Parses Apple Health exports so the data can be queried by an agent.

Natural language search

Lets you ask for records and summaries without writing SQL.

DuckDB-backed queries

Uses DuckDB as the local query engine for health data exploration.

Optional scale-out storage

Supports Elasticsearch and ClickHouse for larger or different search setups.

MCP tools

Provides tools for structure analysis, record search, type-based extraction, and trend summaries.

Docker support

Includes Docker files and compose setup for containerized runs.

README

Apple Health MCP Server

Apple Health Data Exploration

Contact us Visit Momentum MIT License

Apple Health Server MCP server

[!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

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

(back to top)

💼 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

Files in the repo

Repository payload22 top-level entries
  • .github
  • app
  • config
  • docs
  • scripts
  • tests
  • .dockerignore
  • .gitignore
  • .pre-commit-config.yaml
  • .python-version
  • docker-compose.yml
  • Dockerfile
  • Dockerfile.ch
  • Dockerfile.uv
  • glama.json
  • LICENSE
  • logging.conf
  • Makefile
  • pyproject.toml
  • README.md
  • start.py
  • uv.lock

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface

86k

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
2akouwu/
reverify

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k
t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

19k