Back to Skills

health-data

Query Apple Health SQLite database for vitals, activity, sleep, and workouts. Supports Markdown, JSON, and FHIR R4 output formats. This skill should be used when analyzing health metrics, generating health reports, answering questions about fitness or sleep patterns, or exporting health data in standard formats.

17stars1forksUpdated 2/21/2026

Security Assessment

Safe(100/100)
Security Score100/100

About health-data

The health-data skill is designed to query and analyze health data stored in Apple's SQLite database. It provides insights into various health metrics such as vitals, activity, sleep patterns, and workout history. This skill helps users access and process large volumes of health-related data, enabling them to track trends, analyze fitness progress, and generate health reports in multiple output formats. With the ability to query over 6.3 million records across 43 health metrics, this skill is ideal for anyone needing a comprehensive look at their health data.

The skill supports multiple output formats including Markdown, JSON, FHIR R4, and ASCII, ensuring that the results can be tailored to the needs of different users. It offers pre-built queries for common health metrics like daily summaries, weekly trends, sleep analysis, and workout history. Additionally, users can execute direct SQL queries against the database for highly customized results, giving them flexibility in their analysis. Whether generating health reports, analyzing fitness trends, or exporting data for further use, this skill is a powerful tool for health-conscious individuals and professionals.

The health-data skill is particularly beneficial for individuals who want to monitor and improve their fitness or sleep habits, healthcare providers looking to analyze patient data, or developers building applications that integrate health data insights. By offering both simple queries and advanced SQL capabilities, it caters to a wide range of use cases, from personal health tracking to more complex data analysis in health-related applications.

FAQ

How do I use the health-data skill to get a daily summary of my health metrics?

To get a daily summary, run the following command: `python ~/.claude/skills/health-data/scripts/health_query.py daily`.

What output formats does this skill support?

The skill supports the following output formats: Markdown (default), JSON, FHIR R4, and ASCII.

Can I use SQL for custom queries?

Yes, you can run custom SQL queries directly against the health database by using the `sqlite3` command with the health.db file.

Where is the health database stored?

The health database is located at `~/data/health.db`.

What are the main health metrics available through this skill?

The skill provides access to 43 health metrics, including vitals (heart rate, blood oxygen), activity, sleep, and workout history.

Install health-data

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill