Skip to main content
Glama
Apple Health Chat MCP

Apple Health Chat MCP

by gh33k

Apple Health Chat MCP

Ask Claude natural language questions about your Apple Health data! This MCP server enables conversational analysis of your health metrics from iOS Health Export CSV files.

Example questions you can ask:

  • "How active was I yesterday?"

  • "Did I get enough sleep this week?"

  • "What's my step count trend?"

  • "Was my heart rate higher than usual today?"

Quick Start

  1. Install & Build:

    npm install && npm run build
  2. Set up your health data:

    export HEALTH_EXPORT_DIR="/path/to/your/health/export/files"
  3. Configure Claude Desktop:

    {
      "mcpServers": {
        "apple-health-chat": {
          "command": "node",
          "args": ["/path/to/apple-health-chat-mcp/dist/index.js"],
          "env": {
            "HEALTH_EXPORT_DIR": "/path/to/your/health/files"
          }
        }
      }
    }
  4. Start asking questions! Restart Claude Desktop and chat about your health data.

Related MCP server: Apple Health MCP

Features

  • Natural Language Queries: Ask questions in plain English

  • Comprehensive Metrics: Steps, heart rate, sleep, energy, and more

  • Flexible Time Periods: Today, yesterday, last week, custom ranges

  • Local Processing: CSV files stay on your device

  • Privacy Transparent: Query results sent to Claude (not raw data)

Supported Health Metrics

Automatically detects metrics from your Health Export files:

  • Step Count, Heart Rate (Min/Max/Avg)

  • Sleep Analysis, Active Energy

  • And many more from your iOS Health app

Privacy & Data Flow

Your CSV files: Stored and processed locally on your device
When you ask Claude: Query results (like "8,500 steps") are sent to Claude for analysis
Raw health data: Never leaves your device

Get Your Health Data

  1. Use the iOS Health Export app to export your data

  2. Set HEALTH_EXPORT_DIR to point to your CSV files

  3. Keep personal data out of version control (see .gitignore)

Development

npm run dev    # Development mode
npm test       # Run tests
npm run lint   # Lint code

License

MIT

Support

  • Issues - Report bugs or request features


Made with ❤️ for health-conscious people who want to chat with their data

Available Tools

6 tools
health_export_askA

Ask any natural language question about your health data. The LLM will interpret the question and query the appropriate metrics.

Inputs: question (required), date.

health_export_get_metricsA

Get raw health metrics data for a specific date range. Use this when you need to analyze specific metrics or perform custom calculations.

Inputs: end_date (required), start_date (required), metrics.

health_export_metricsC

Get specific metric data with optional filtering and aggregation

Inputs: metric_name (required), end_date, start_date, aggregation.

health_export_queryB

Execute SQL-like queries on health data from Health Export CSV files

Inputs: query (required), format.

health_export_reportC

Generate structured health reports for specific time periods

Inputs: report_type (required), end_date, start_date, include_metrics.

health_export_schemaA

Get available metrics, date ranges, and sample data from health export files

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 6 tools

    Disambiguation2/5

    Multiple tools have overlapping purposes: health_export_metrics and health_export_get_metrics both retrieve metric data with filtering, and health_export_query can also be used for similar queries. health_export_ask is a catch-all natural language interface that may subsume the others, creating confusion about which tool to select.

    Naming Consistency3/5

    All tools share the 'health_export_' prefix, but the suffixes mix verb forms (query, report, ask, get_metrics) with noun forms (schema, metrics). The similar names 'health_export_metrics' and 'health_export_get_metrics' further reduce consistency.

    Tool Count5/5

    With 6 tools, the server is well-scoped for querying and analyzing Apple Health export data. Each tool has a place in the workflow, and the count is within the ideal range for a domain-specific server.

    Completeness4/5

    The server covers schema discovery, raw data retrieval, aggregated metrics, reports, and natural language queries, providing a solid read-only query surface. Minor gaps exist, such as no explicit way to list all available export files, but these are not critical for the core purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables Claude Desktop to access and analyze Garmin wearable health data including sleep, HRV, Body Battery, and activity metrics. Users can query their health trends, track recovery, and generate interactive HTML dashboards using natural language.
      9
      7
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables users to query Apple Health metrics, workouts, and trends from CSV files exported via the Health Auto Export app. It allows MCP clients to analyze health data such as heart rate, sleep stages, and activity levels directly from local iCloud Drive storage.
      3
      9 npm
      2
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Enables Claude to directly access, query, and analyze local CSV files using natural language, keeping data private and local.
      4
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides Claude with real-time access to local health data including sleep, recovery, strain, and workouts from WHOOP and Apple Health, enabling informed context-aware interactions.
      6
      1
      MIT