health-export-mcp: Instructions file for Codex

Using health-export-mcp with your AI client

Copy-paste setup for every supported agent. The server is a single Node script (server.mjs, zero dependencies). Point HEALTH_DATA_DIR at the folder that holds your exported .health-cache.json, by default the MetricBridge iOS app (App Store) writes it to your iCloud Drive container:

~/Library/Mobile Documents/iCloud~ai~healthexport~app/Documents

Tip: get the absolute path to server.mjs with node -e "console.log(process.cwd()+'/server.mjs')" (run inside the repo), or let node apply-mcp-config.mjs write the config for you.

After configuring, restart the client and ask: "Use health-export: what's my HRV trend this week?"

---

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "health-export": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/health-export-mcp/server.mjs"],
      "env": { "HEALTH_DATA_DIR": "~/Library/Mobile Documents/iCloud~ai~healthexport~app/Documents" }
    }
  }
}

Or drag health-export.mcpb into Claude Desktop → Settings → Extensions (no JSON).

Cursor

~/.cursor/mcp.json (same mcpServers shape as above), or run node gen-deeplinks.mjs for a one-click install link.

VS Code (Copilot / Continue)

Run node gen-deeplinks.mjs and open the generated VS Code link, or add the server under your MCP settings.

opencode

opencode.json (project root) or ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "health-export": {
      "type": "local",
      "command": ["node", "/ABSOLUTE/PATH/TO/health-export-mcp/server.mjs"],
      "enabled": true,
      "environment": { "HEALTH_DATA_DIR": "~/Library/Mobile Documents/iCloud~ai~healthexport~app/Documents" }
    }
  }
}

OpenClaw

Add the health-export block (same shape as Claude Desktop's mcpServers entry) to your OpenClaw MCP servers config, then reload.