apple-health-mcp-server — Claude Code skill: setup and tools
Connects your Apple Health export to an AI agent through local or remote databases. Useful for checking activity metrics and pulse trends in chat.
no license 120 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a claude-codeWhat apple-health-mcp-server does
This skill helps your agent run a FastMCP server for Apple Health exports. It stores records in DuckDB, ClickHouse, or Elasticsearch. Once imported, the assistant can filter records and calculate moving averages across your health metrics.
You need Python 3.10 and a raw export.xml file. Without that export, the server cannot start. Configuration is handled through environment variables or Docker.
What it helps with
- parse Apple Health XML files into DuckDB or ClickHouse
- aggregate step counts and activity metrics by day or month
- filter health measurements by recording device or unit
- evaluate heart rate changes with moving average trends
Example prompts for the agent
- Analyze the structure of my health export and summarize available types.
- Calculate my daily step statistics for last month.
- Check heart rate readings from the past week and look for trends.
How to install apple-health-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/apple-health-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/apple-health-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a codex2Manually: put the files in place
.agents/skills/apple-health-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/apple-health-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/apple-health-mcp-server2Manually: put the files in place
.github/skills/apple-health-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/apple-health-mcp-serverManually: put the files in place
.devin/skills/apple-health-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about apple-health-mcp-server
How to install apple-health-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill apple-health-mcp-server -a claude-code.
What does apple-health-mcp-server do?
It equips the coding agent with tools to parse exported Apple Health XML files and run analytical queries over the imported data.
Which storage backends can be used?
It uses DuckDB as the default backend, but you can also configure Elasticsearch or ClickHouse using environment variables.