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.