DEV Community

Philip D'Souza
Philip D'Souza

Posted on

v1.4.0: Apple Health MCP now answers workouts, sleep sessions, events, and correlation

#cli #mcp #software #tools

v1.4.0 ships six new read-only tools on top of the eight metric queries, plus 22 MCP prompts, demo mode, and a CLI. The server now answers the questions a health log actually holds, not just the numbers.

New tools (6), 14 total

  • list_events for clinical and lifestyle events tagged to days: illness, medication, travel, fasts.
  • get_workouts for structured workout sessions with type, duration, distance, energy.
  • get_profile for sex, age range, blood type, device list. The context every other answer depends on.
  • get_sleep_sessions for per-night sleep architecture instead of one collapsed number.
  • get_cycle_context for menstrual cycle phase and day, so HRV and sleep correlations land in the right hormonal window.
  • correlate_metrics ranks correlation between two metrics over a window and names the segment boundary behind the number, so a strong correlation is not a travel-day artifact.

22 MCP prompts

The server now advertises prompts. Trend reads, period comparisons, workout summaries, sleep reviews, cycle-aware analysis, caregiver check-ins. Clients with a prompts panel get a one-click entry into each.

Honesty fixes

Trend and period-comparison answers now name the segment boundary they used, not a smooth average that hides it. Day filters, excludeTravelDays, and anchor comparisons on correlate_metrics.

Demo mode and CLI

  • npx -y health-export-mcp --demo serves a watermarked synthetic dataset. Zero setup. Useful for evaluation, screenshots, and registry indexers.
  • --doctor runs diagnostics on the cache file and environment.
  • status --max-age freshness gate.
  • receive mode for the webhook bridge.

Tooling

readOnly and idempotent annotations on every tool. File contracts in docs/SCHEMA-CONTRACTS.md. Caregiver and Shortcuts write-bridge patterns in docs/. 101 unit tests and 42 integration checks green.

Zero dependencies. Zero network calls. Local-first only. Same npx -y health-export-mcp.

Docs and install: https://healthexport.dev/mcp?utm_source=devto&utm_medium=social&utm_campaign=exp-20260819-hea84-v140

Top comments (0)