Cross-device setup
Set up Vaultbeat on this computer
Run these commands on the machine where your AI agent lives — not on your phone. Three steps in this order, then a self-check if anything is off. Select any block to copy it.
Before you start: uv
Every command below runs through uvx, which ships with uv. It is not preinstalled anywhere. If your computer doesn't have it yet, install it first — macOS and Linux use the first line, Windows PowerShell the second:
curl -LsSf https://astral.sh/uv/install.sh | sh
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Already have it? uvx --version prints a version instead of command not found. To install it another way, see uv's own install guide. You do not need to install Python separately — uv handles that.
Pair this computer
uvx vaultbeat-apple-health@latest bind
This prints a QR code and then waits for you to scan it. Leave it running. @latest is load-bearing: without it, uvx reuses whatever version it cached the first time it ran on this machine, the same way pip never updates once installed.
Scan it with your iPhone
In the Vaultbeat app, open MCP tab → Connect an AI server (app 1.2.8 and earlier: Settings → Data & AI). Before your first pairing, that opens a short setup guide rather than the camera — tap Step 2 · Scan the QR code it prints pinned at its bottom. Then point the camera at the code in your terminal.
The code carries a one-time pairing payload and this computer's public key. The private half of the keypair that bind just generated stays on this machine and is never uploaded. From the scan onward, your iPhone seals an encrypted copy of each record for this machine — our servers only ever hold ciphertext.
When the terminal says bound, the pairing is done. Your first pairing also starts three days of full agent access.
Tell your agent about it
claude mcp add vaultbeat-health -- uvx vaultbeat-apple-health@latest serve --transport stdio
That line is for Claude Code. Claude Desktop, Hermes, OpenClaw and anything else that speaks MCP take the same server a different way — the full guide has the exact config for each.
Then ask it: “How did I sleep last night?”
Something off? Run the self-check
uvx vaultbeat-apple-health@latest doctor
It checks the pairing, the connection and whether your data is arriving, and says which part is wrong.
No app installed yet?
This page pairs a computer with the Vaultbeat iOS app. The app is what reads Apple Health and encrypts it on your iPhone.
Something not working?
serve prints nothing and never shows a QR code — it is the protocol loop your agent talks to. bindis the one that draws the code, so don't sit waiting on the wrong command.
If your agent stops reading later, check status before re-pairing — a degraded service resolves on its own. Step 4's self-check says which part is wrong, and the full guide covers the rest, or email support@vaultbeat.app.