# Apple Health (MCP server)

> Apple Health is an MCP server that adds data and analytics tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Local-first Apple Health MCP server for questions about your sleep, workouts and heart data. It has 570 GitHub stars, is released under the MIT license and runs locally with npx -y @neiltron/apple-health-mcp.

Query Apple Health data from an MCP client using SQL and DuckDB. The server runs locally, reads CSV exports on demand, and provides tools for schema discovery, analytical queries, and health summaries.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/neiltron/apple-health-mcp |
| GitHub stars | 570 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @neiltron/apple-health-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Data & analytics |
| Latest release | v1.4.5 (Sep 20, 2026) |
| Last commit | Oct 2, 2026 |
| MCP registry name | io.github.neiltron/apple-health-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": [
        "-y",
        "@neiltron/apple-health-mcp"
      ],
      "env": {
        "HEALTH_DATA_DIR": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env HEALTH_DATA_DIR=your-value --transport stdio apple-health -- npx -y @neiltron/apple-health-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "apple-health": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@neiltron/apple-health-mcp"
      ],
      "env": {
        "HEALTH_DATA_DIR": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "apple-health": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@neiltron/apple-health-mcp"
      ],
      "env": {
        "HEALTH_DATA_DIR": "your-value"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `HEALTH_DATA_DIR` (required): Path to the Apple Health CSV export directory
- `MAX_MEMORY_MB`: Maximum memory usage in megabytes
- `CACHE_SIZE`: Maximum number of cached query results

## Tools

- `health_schema`: Discover table names, columns, units, and sample rows
- `health_query`: Run one DuckDB SELECT-family analytical statement with JSON, CSV, or summary output
- `health_report`: Generate a weekly, monthly, or custom health summary

## Similar MCP servers

- [Ida Pro MCP](https://appsgit.com/mcp-servers/ida-pro-mcp): AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP. (12,497 stars, MIT)
- [Ask Jev](https://appsgit.com/mcp-servers/ask-jev): Evaluate state with typed choice, score, and probability questions. (5,174 stars, MIT, needs API key)
- [Jitsu](https://appsgit.com/mcp-servers/jitsu): Manage Jitsu data pipelines: destinations, streams, connections, functions, live events. (5,101 stars, MIT, official)
- [Google Ads + Meta Ads + SEO/GEO MCP](https://appsgit.com/mcp-servers/google-ads-meta-ads-seo-geo-mcp): Google Ads, Meta Ads, SEO, GEO & GA4 MCP by Ryze AI - audits, reports, keywords, Search Console. (4,107 stars, MIT)
- [Blitz](https://appsgit.com/mcp-servers/blitz): Give AI agents full control over iOS/macOS development via a native macOS app with 30+ MCP tools. (1,754 stars, Apache-2.0)
- [Chunkhound](https://appsgit.com/mcp-servers/chunkhound): Your entire engineering context, deeply understood. (1,445 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/apple-health
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.