PulsHealth

Sync and export your Apple Health data.

Export files from your iPhone or iPad, or keep your health history in a database you control. PulsHealth includes the app, a self-hosted stack, and an open sync protocol. Everything in this repository is Apache-2.0.

Get the iOS app · Self-host it · Read the docs

Make something with your data

Explore cool examples: a health year in review, marathon training, activity as art, and an atlas of walks, runs and rides. Explore recorded examples, then use your own files with the local adapter and instructions.

Get started

• Export files: install the app, grant Health access, and choose the types, dates, and format in Export. Export guide.
• Sync to your database: run the Docker stack and pair your phone. It includes PostgreSQL + TimescaleDB, a web dashboard, Grafana, and APIs. Setup guide.

The app reads Apple Health without modifying it. Background sync depends on iOS, Health access, and Watch-to-phone delivery. The self-hosted backend is pre-release (0.x); see the setup guide for networking and backups.

See the dashboard

Explore activity, sleep, heart rate, and workouts in your browser. Try the interactive demo with sample data.

See the app

App captures use synthetic data. Image provenance.

Build with your data

Use case	Guide
Query your database	Schema and query patterns
Build an app or integration	Product API
Connect an AI assistant	Read-only MCP tools
Automate your home	Home Assistant integration
Write your own receiver	Sync protocol · Python + SQLite example

AI tools share the records they read with your chosen AI provider.

Documentation and development

• App · Swift sync library
• Server · Web dashboard
• HealthKit type reference
• Sync troubleshooting
• Contributing and tests · Roadmap
• Security · Privacy · License · Trademarks