apple-health

Parse Apple Health export archives into structured CSV files.

Updated May 12, 2026
One-click install
npx skills add https://github.com/aquiladev/claude-skills --skill apple-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-health
Source: https://github.com/aquiladev/claude-skills/tree/main/skills/apple-health
Command: npx skills add https://github.com/aquiladev/claude-skills --skill apple-health

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, numpy, lxml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the challenge of analyzing massive, multi-gigabyte Apple Health XML exports that typically cause memory crashes in standard environments.

Core Features & Use Cases

  • Efficient Parsing: Streams large export files into tidy, queryable CSVs per metric using memory-efficient techniques.
  • Specialized Analysis: Includes dedicated tools for parsing ECG waveforms, GPX workout routes, and clinical CDA records.
  • Use Case: Quickly aggregate years of step counts, visualize heart rate trends, or map your longest running routes by joining workout data with GPS files.

Quick Start

Use the apple-health skill to parse the export.xml file in the current directory and generate a folder of clean CSVs for analysis.

Frequently Asked Questions about apple-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I parse a multi-gigabyte Apple Health export.xml file without running out of memory?

To parse a multi-gigabyte Apple Health export.xml file without memory crashes, you need stream-based XML processing. This approach reads the document sequentially, preventing memory exhaustion while converting large HealthKit datasets into structured CSV formats.

Can I extract ECG waveforms and GPX workout routes from Apple Health data?

You can extract ECG waveforms and GPX workout routes from Apple Health data using specialized parsing tools. This process transforms raw HealthKit records and GPS files into structured formats, enabling efficient clinical analysis and route mapping.

What is the best way to convert HealthKit metrics into tidy CSVs for pandas data analysis?

The best way to convert HealthKit metrics into tidy CSVs for pandas data analysis is through specialized XML parsing. This process streams complex Apple Health export data into queryable formats, allowing you to aggregate step counts or visualize heart rate trends efficiently.

Does this tool support extracting clinical CDA records from HealthKit exports?

This tool does support extracting clinical CDA records from HealthKit exports. It includes dedicated components designed to parse clinical documents alongside standard fitness tracking metrics, structuring them for immediate data analysis within your environment.

Why does parsing Apple Health XML with pandas cause memory crashes on large datasets?

Parsing Apple Health XML with pandas causes memory crashes on large datasets because standard methods load the entire document into RAM. Using stream-based XML processing avoids this by reading sequentially, generating per-metric CSVs without exhausting memory.

Do I need to install lxml and numpy to analyze HealthKit data with this skill?

You do need to install lxml and numpy to analyze HealthKit data with this skill. These dependencies provide the foundational stream-based XML parsing and numerical operations required to process multi-gigabyte Apple Health export archives efficiently.