healthkit-sync
iOS HealthKit data sync CLI commands and patterns. Use when working with healthsync CLI, fetching Apple Health data (steps, heart rate, sleep, workouts), pairing iOS devices over local network, or understanding the iOS Health Sync project architecture including mTLS certificate pinning, Keychain storage, and audit logging.
Why use this skill?
Use the healthkit-sync skill to securely transfer Apple Health data to your Mac using mTLS, certificate pinning, and local network discovery for private analytics.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/mneves75/healthkit-syncWhat This Skill Does
The healthkit-sync skill enables seamless, secure, and private data synchronization between Apple HealthKit and your local machine via the healthsync CLI. It facilitates the extraction of health metrics—including steps, heart rate, sleep cycles, and workout data—directly from your iPhone to your desktop. By leveraging mutual TLS (mTLS) with certificate pinning, it ensures that your sensitive health information is transferred only to authorized devices over a private, local network. The skill handles the complexities of device discovery, secure QR-code based pairing, and Keychain-backed credential management, providing a unified interface for data analysis and health tracking.
Installation
To integrate this skill into your environment, run the following command via the OpenClaw CLI:
clawhub install openclaw/skills/skills/mneves75/healthkit-sync
Ensure you have the required dependencies installed on your system path and that your macOS Keychain is configured to allow the CLI to store and retrieve authentication tokens.
Use Cases
- Personal Analytics: Aggregate workout and sleep data over a custom date range for deep analysis in Excel, Python, or data visualization tools.
- Security-Conscious Health Tracking: Ideal for users who want to move health data off of closed cloud ecosystems while maintaining strict local security protocols like certificate pinning.
- Workflow Automation: Use the
healthsyncCLI to automatically pull daily activity logs and append them to a local database or personal dashboard. - Cross-Device Pairing: Manage pairing between a secure Mac environment and an iPhone, ensuring that only trusted devices can initiate data transfer.
Example Prompts
- "OpenClaw, please sync my heart rate and sleep data from the last 30 days and export it to a JSON file named health_summary.json."
- "I'm setting up a new device; can you walk me through the pairing flow for my iPhone and explain how the certificate fingerprinting works?"
- "Show me the status of my current healthsync connection and list all the activity types I am currently authorized to fetch."
Tips & Limitations
- Security First: Always ensure your
~/.healthsync/config.jsonremains restricted with 0600 permissions. The skill relies on strict TOFU (Trust On First Use) security models; if you receive a fingerprint mismatch error, verify your network settings immediately. - Network Scope: This skill is strictly designed for local network synchronization. It will not work over external cellular or non-local Wi-Fi networks as a security precaution.
- Data Types: Ensure the specific data types requested exist within your Apple Health app permissions, or the sync command may return an empty set.
- Performance: For large date ranges (e.g., several years of high-frequency heart rate data), consider piping the output directly to a file rather than rendering it in the console to avoid memory bottlenecks.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-mneves75-healthkit-sync": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read