Apple MCP Server

Unofficial local-first MCP server for Apple Health export data.

Local serverstdio

What is the Apple MCP Server?

Unofficial local-first MCP server for Apple Health export data.

What you get

What the assistant can call

Once Apple is connected, these are the calls the assistant has available:

  • apple_health_connection_status — verify export path before reading data
  • apple_health_data_inventory — discover available record types, date coverage, sources count and stale export risk
  • apple_health_daily_summary — daily wellness brief from export data
  • apple_health_weekly_summary — weekly comparison and habit signals
  • apple_health_list_records — bounded records by type (e.g. HKQuantityTypeIdentifierStepCount), start, end, limit. limit caps the returned list only: in the default summary
  • apple_health_list_workouts — bounded workouts by start, end, limit. Same contract: limit caps the returned list only, and in summary privacy mode the aggregate totals
  • apple_health_reimport — re-scan the watch folder (APPLE_HEALTH_WATCH_PATH) and promote the newest export, refreshing summaries; pass check_only: true to preview without

Configuration and credentials

  • Node.js 20+ - An Apple Health export from your iPhone (Health app → profile → Export All Health Data)

Recorded tools

  • apple_health_connection_status — verify export path before reading data
  • apple_health_data_inventory — discover available record types, date coverage, sources count and stale export risk
  • apple_health_daily_summary — daily wellness brief from export data
  • apple_health_weekly_summary — weekly comparison and habit signals
  • apple_health_list_records — bounded records by type (e.g. HKQuantityTypeIdentifierStepCount), start, end, limit. limit caps the returned list only: in the default summary privacy mode the aggregate block (min/max/sum/average/count/date_range) i
  • apple_health_list_workouts — bounded workouts by start, end, limit. Same contract: limit caps the returned list only, and in summary privacy mode the aggregate totals (total_energy_kcal, total_duration_minutes, total_distance, count_by_activity,
  • apple_health_reimport — re-scan the watch folder (APPLE_HEALTH_WATCH_PATH) and promote the newest export, refreshing summaries; pass check_only: true to preview without promoting

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
apple_health_connection_statusverify export path before reading data
apple_health_data_inventorydiscover available record types, date coverage, sources count and stale export risk
apple_health_daily_summarydaily wellness brief from export data
apple_health_weekly_summaryweekly comparison and habit signals
apple_health_list_recordsbounded records by type (e.g. HKQuantityTypeIdentifierStepCount), start, end, limit. limit caps the returned **list** only: in the default summary privacy mode the aggregate block (min/max/sum/average/count/date_range) i
apple_health_list_workoutsbounded workouts by start, end, limit. Same contract: limit caps the returned **list** only, and in summary privacy mode the aggregate totals (total_energy_kcal, total_duration_minutes, total_distance, count_by_activity,
apple_health_reimportre-scan the watch folder (APPLE_HEALTH_WATCH_PATH) and promote the newest export, refreshing summaries; pass check_only: true to preview without promoting

How to install the Apple MCP Server

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": ["-y", "delx-wellness-hermes"],
      "env": {
        "APPLE_HEALTH_WATCH_PATH": "your-value",
        "APPLE_HEALTH_EXPORT_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js 20+ - An Apple Health export from your iPhone (Health app → profile → Export All Health Data)
VariableDescriptionRequired
APPLE_HEALTH_WATCH_PATHFilesystem location the server is allowed to use.Optional
APPLE_HEALTH_EXPORT_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Apple to apple health connection status.”
  • “Use Apple to apple health data inventory.”
  • “Use Apple to apple health daily summary.”

Frequently asked questions

Unofficial local-first MCP server for Apple Health export data. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.