Aion Bridge MCP

Connect Claude Code to your personal health data via the Aion local FHIR bridge. Everything stays on your local network — no cloud, no servers, no data leaving your home.

How it works

Your phone (Aion app)
    ↕  WebSocket on local WiFi (port 8420)
Your PC (this MCP server)
    ↕  stdio
Claude Code

Claude gets tools to query your FHIR health records (vitals, labs, conditions, medications, and more) and can reason about them directly.

Quickstart

Option A — npx (recommended, no install needed)

# One-time setup: finds your phone, writes .mcp.json
npx aion-bridge-mcp setup

# Then restart Claude Code — it will pick up .mcp.json automatically

Option B — Download binary (no Node.js required)

Download the latest binary for your OS from Releases:

| Platform | Binary | |----------------|---------------------------------| | macOS (Apple) | aion-bridge-mcp-macos-arm64 | | macOS (Intel) | aion-bridge-mcp-macos-x64 | | Linux (x64) | aion-bridge-mcp-linux-x64 | | Linux (ARM64) | aion-bridge-mcp-linux-arm64 | | Windows | aion-bridge-mcp-windows.exe |

# macOS / Linux — make executable
chmod +x aion-bridge-mcp-macos-arm64

# Run setup wizard
./aion-bridge-mcp-macos-arm64 setup

Option C — Docker

docker run -i --rm \
  -e AION_BRIDGE_URL=wss://192.168.1.100:8420 \
  -e AION_PAIRING_CODE=123456 \
  ghcr.io/aion-open/bridge-mcp:latest

.mcp.json for Docker:

{
  "mcpServers": {
    "aion-health": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
               "-e", "AION_BRIDGE_URL",
               "-e", "AION_PAIRING_CODE",
               "ghcr.io/aion-open/bridge-mcp:latest"],
      "env": {
        "AION_BRIDGE_URL": "wss://192.168.1.100:8420",
        "AION_PAIRING_CODE": "123456"
      }
    }
  }
}

Prerequisites

1. Aion app installed on your iPhone (Android coming soon)
2. Phone and PC on the same WiFi network
3. Bridge running: Aion app → Settings → Bridge → Start Bridge
4. Note the 6-digit pairing code shown in the app

.mcp.json reference

After running setup, Claude Code will use this config automatically.
To configure manually:

{
  "mcpServers": {
    "aion-health": {
      "command": "npx",
      "args": ["-y", "aion-bridge-mcp"],
      "env": {
        "AION_BRIDGE_URL": "wss://192.168.1.100:8420",
        "AION_PAIRING_CODE": "123456"
      }
    }
  }
}

AION_BRIDGE_URL is optional — if omitted, the server will auto-discover your phone via Bonjour/mDNS and TCP scan.

Available tools

| Tool | Description | |---------------------|--------------------------------------------------| | get_health_summary| Counts of all FHIR resources by type | | query_health_data | Query specific types (Observation, Condition…) | | analyze_health | Natural language health question (needs Ollama) | | export_health_data| Full FHIR Bundle export |

CLI subcommands

npx aion-bridge-mcp setup      # Interactive setup wizard
npx aion-bridge-mcp discover   # Scan for phone, print URL

Privacy

• All data served over local WiFi only — never leaves your network
• Pairing code prevents unauthorized access
• TLS with self-signed cert encrypts the connection
• No telemetry, no analytics, no cloud

Building from source

git clone https://github.com/aion-open/bridge-mcp
cd bridge-mcp
npm install
npm run build
node dist/index.js setup

Build standalone binaries (requires Node 20):

npm install     # installs esbuild + pkg
npm run pkg:all # builds all 5 platform binaries → bin/