healthsync

Query Apple Health metrics from a local SQLite database via CLI or SQL.

64|5|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/BRO3886/healthsync --skill healthsync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: healthsync
Source: https://github.com/BRO3886/healthsync/tree/main/cmd/skills/healthsync
Command: npx skills add https://github.com/BRO3886/healthsync --skill healthsync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple Health data is stored locally in a SQLite database, and this skill provides easy, read-only access for AI agents and CLIs to query it without requiring manual SQL boilerplate.

Core Features & Use Cases

  • Read Apple Health metrics from a local SQLite database via the healthsync CLI or direct SQL.
  • Supports querying across multiple tables (heart_rate, resting_heart_rate, steps, sleep, workouts, etc.) with date-range filters and optional deduplicated totals.
  • Real-world use: pull last 7 days of heart-rate, steps, and sleep to feed an AI agent with up-to-date health trends.

Quick Start

Run a sample query with the healthsync CLI to fetch heart-rate data from your local database.

Frequently Asked Questions about healthsync

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

FAQPage Schema
How do I query Apple Health data from a local SQLite database?▼

You can query Apple Health data by using the healthsync CLI or direct SQL to read metrics from a local SQLite database located at ~/.healthsync/healthsync.db. This provides read-only access without manual SQL boilerplate.

Can I retrieve resting heart rate and workout metrics across specific date ranges?▼

Yes, you can retrieve resting heart rate and workout metrics across specific date ranges. The skill supports querying multiple tables with date-range filters and optional deduplicated totals for accurate health data analysis.

What is needed to run local SQL queries against my Apple Health metrics?▼

You need the healthsync binary installed and a populated SQLite database at ~/.healthsync/healthsync.db. This setup ensures safe SQL querying and read-only access to your health metrics.

Does this approach support read-only access for AI agents to analyze health trends?▼

Yes, it supports read-only access specifically designed for AI agents and CLIs. You can pull recent steps, sleep, and heart-rate data to feed an AI agent up-to-date health trends safely.

What's the best way to fetch multiple health metrics like steps and sleep without writing manual SQL?▼

The best way is using the healthsync CLI, which abstracts manual SQL boilerplate. It allows you to easily fetch steps, sleep, and heart-rate data from multiple tables using built-in query functions.

Are there limitations when querying Apple Health data via direct SQL in a local environment?▼

The primary limitation is that queries are restricted to read-only access to ensure data safety. Additionally, the database must be pre-populated at ~/.healthsync/healthsync.db for any CLI or SQL queries to return results.