ingest-health

Ingest Apple Health data into the local DuckDB used by health-mcp.

31|20|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ingest-health
Source: https://github.com/mycelium-hq/ai-brain-starter/tree/main/skills/ingest-health
Command: npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple Health stores sensitive biometric data across devices. This Skill ingests that data into the local DuckDB used by health-mcp, enabling downstream analytics without touching the vault.

Core Features & Use Cases

  • Supports three ingestion modes: XML export.zip, Simple Health Export CSV folder, and Health Auto Export TCP-live.
  • Idempotent by design: re-running without force is a no-op; vault remains unchanged.
  • Reads data into the local DuckDB at ~/.claude/health-mcp/health.duckdb for use by daily-journal, coaching, patterns, and insights.
  • Use Case: import a fresh Apple Health export to seed your analytics stack, or sync ongoing data from a live TCP stream for real-time dashboards.

Quick Start

Export your Apple Health data (XML zip or Simple Health CSV folder) and run this skill to import it into the local DuckDB.

Frequently Asked Questions about ingest-health

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

FAQPage Schema
How do I ingest Apple Health data into DuckDB for local analytics?

You can ingest Apple Health data into DuckDB by importing an XML export zip, a Simple Health Export CSV folder, or a live Health Auto Export TCP stream using an orchestrator script that feeds the local health-mcp database.

What is the best way to import an Apple Health XML export into a local database?

The best way to import an Apple Health XML export locally is to use a skill that reads the export zip and loads the health metrics directly into a local DuckDB instance for downstream analytics without writing to the vault.

Can I stream Apple Health metrics into DuckDB in real-time?

Yes, you can stream Apple Health metrics into DuckDB in real-time by connecting to a Health Auto Export TCP stream, allowing the ingestion process to continuously feed live data into your local analytics database.

Does re-running the Apple Health ingest process overwrite existing data in DuckDB?

Re-running the Apple Health ingest process is idempotent and acts as a no-op unless you explicitly specify force, ensuring your existing DuckDB health data and vault remain unchanged during duplicate imports.

What file formats are supported for importing Apple Health exports into DuckDB?

Supported file formats for importing Apple Health exports into DuckDB include an XML export zip file, a Simple Health Export CSV folder, or a live Health Auto Export TCP stream for downstream health analytics.