healthkit-sync

Synchronize HealthKit data between iPhone and Mac via healthsync CLI.

42|7|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/mneves75/ai-health-sync-ios --skill healthkit-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: healthkit-sync
Source: https://github.com/mneves75/ai-health-sync-ios/tree/main/skills/healthkit-sync
Command: npx skills add https://github.com/mneves75/ai-health-sync-ios --skill healthkit-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill enables secure, local-network synchronization of HealthKit data between iPhone and Mac using the healthsync CLI, eliminating the need for cloud-based transfers and ensuring data stays on-device.

Core Features & Use Cases

  • Local pairing & data transfer: Discover devices, pair via QR codes, and fetch health data such as steps, heart rate, sleep, and workouts without leaving the local network.
  • Architecture & security patterns: Understand mTLS certificate pinning, Keychain storage, and audit logging within the HealthSync project.
  • Use Case: A clinician or developer exports Apple HealthKit data to a Mac for offline analysis and reporting.

Quick Start

  • Discover devices: healthsync discover
  • Pair via QR: healthsync scan
  • Fetch data: healthsync fetch --start 2026-01-01 --end 2026-12-31 --types steps,heartRate,sleepAnalysis
  • Check status: healthsync status

Frequently Asked Questions about healthkit-sync

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

FAQPage Schema
How do I sync HealthKit data between iPhone and Mac over a local network?

HealthKit data sync transfers health information like steps, heart rate, and sleep from iPhone to Mac using the healthsync CLI over a secure local connection. Pair devices via QR code with `healthsync scan`, then fetch data using `healthsync fetch` with date ranges and data types. Data remains on-device without cloud transfer.

What security does local HealthKit synchronization provide?

Local HealthKit sync uses mTLS certificate pinning to encrypt data in transit, stores credentials in iOS Keychain, and maintains audit logging of all transfers. This ensures data never leaves your local network and remains protected from interception.

Can I use healthsync to export HealthKit data for offline analysis?

Yes. The healthsync CLI lets you fetch HealthKit data—steps, heart rate, sleep, workouts—from iPhone to Mac and export it for offline analysis and reporting without requiring cloud services or internet connectivity.

How do I discover and pair devices with healthsync?

Use `healthsync discover` to find devices on your local network, then `healthsync scan` to initiate pairing via QR code. Check pairing status with `healthsync status` before fetching data.

What health data types can healthsync transfer?

healthsync transfers steps, heart rate, sleep analysis, and workouts from HealthKit. Specify data types in the fetch command using the `--types` parameter with comma-separated values.

Does healthsync work offline after pairing?

Yes. After initial pairing, healthsync operates entirely on the local network without internet. Data transfers, certificate pinning, and Keychain storage all function offline for continuous secure access.