How mwdearing/health-relay works
HealthRelay moves permitted Apple Health data from an iPhone companion to a self-hosted receiver, then exposes it to AI agents through read-only MCP and CLI queries. The main path is HealthKit or confirmed on-device export import, batch/outbox delivery, receiver acceptance and SQLite storage, then read-only access. The graph also preserves the documented mailbox option and major data lanes. Some links are supported only by the README or SOURCE INDEX; unsampled implementation details are not inferred.
Main entry points: HealthBridgeCompanionViewModel.swift Companion UI and sync · server.py Receiver HTTP service · database.py SQLite database · HealthBridgeCompanionCore Health data readers
Components 20
iPhone companion
- Companion UI and sync
ios/HealthBridgeCompanion/App/HealthBridgeCompanionViewModel.swift - Health data readers
ios/HealthBridgeCompanion/Sources/HealthBridgeCompanionCore - Batch factories
ios/HealthBridgeCompanion/Sources/HealthBridgeCompanionCore - Export lab importer
ios/HealthBridgeCompanion/Sources/HealthBridgeCompanionCore/AppleHealthExportLabImporter.swift - Import review
ios/HealthBridgeCompanion/App/ExportImportReviewView.swift
Delivery and pairing
- File outbox
ios/HealthBridgeCompanion/Sources/HealthBridgeCompanionCore/FileOutbox.swift - Background uploader
ios/HealthBridgeCompanion/App/BackgroundURLSessionOutboxUploader.swift - Receiver client
ios/HealthBridgeCompanion/Sources/HealthBridgeCompanionCore/ReceiverClient.swift - Mailbox transport
ios/HealthBridgeCompanion/Sources/HealthBridgeCompanionCore/MailboxTransport.swift
Receiver and storage
- Receiver HTTP service
src/health_bridge/receiver/server.py - Batch acceptance
src/health_bridge/receiver/batch_acceptance.py - Batch ingestion
src/health_bridge/ingest.py - SQLite database
src/health_bridge/storage/database.py
Read-only access
- CLI queries
src/health_bridge/cli_query.py - Health queries
src/health_bridge/queries - Read-only MCP
src/health_bridge/mcp/server.py - MCP query tools
src/health_bridge/mcp/tools.py
Other components
- iPhone owner
- AI agent
- Apple HealthKit
Connections 22
- iPhone owner → Companion UI and sync: uses
README.md - Apple HealthKit → Health data readers: provides data
README.md - Companion UI and sync → Health data readers: reads
ios/HealthBridgeCompanion/App/HealthBridgeCompanionViewModel.swift - Health data readers → Batch factories: builds batches
- Companion UI and sync → Export lab importer: imports export
ios/HealthBridgeCompanion/App/HealthBridgeCompanionViewModel.swift - Export lab importer → Import review: presents counts
ios/HealthBridgeCompanion/App/ExportImportReviewView.swift - Import review → Companion UI and sync: confirms send
README.md - Companion UI and sync → File outbox: queues batches
ios/HealthBridgeCompanion/App/HealthBridgeCompanionViewModel.swift - Background uploader → File outbox: schedules uploads
ios/HealthBridgeCompanion/App/BackgroundURLSessionOutboxUploader.swift - Companion UI and sync → Receiver client: pairs and uploads
ios/HealthBridgeCompanion/App/HealthBridgeCompanionViewModel.swift - Receiver client → Receiver HTTP service: sends privately
README.md - File outbox → Mailbox transport: optional delivery
README.md - Mailbox transport → Receiver HTTP service: delivers via iCloud
README.md - Receiver HTTP service → Batch acceptance: routes requests
src/health_bridge/receiver/server.py - Batch acceptance → Batch ingestion: accepts batches
- Receiver HTTP service → SQLite database: uses database
src/health_bridge/receiver/server.py - Batch ingestion → SQLite database: writes records
src/health_bridge/ingest.py - AI agent → Read-only MCP: requests tools
README.md - Read-only MCP → MCP query tools: dispatches calls
src/health_bridge/mcp/server.py - CLI queries → Health queries: runs queries
src/health_bridge/cli_query.py - Health queries → SQLite database: reads data
- MCP query tools → SQLite database: reads data
src/health_bridge/mcp/tools.py