Vaultbeat

Vaultbeat setup

Set up Vaultbeat on this computer

Run these on the machine where your AI agent lives — not on your phone. Three commands, in this order. Nothing here needs retyping off a small screen: select a block and 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 (macOS / Linux):

curl -LsSf https://astral.sh/uv/install.sh | sh

Already have it? uvx --version prints a version instead of command not found. On Windows, or to install it another way, see uv's own install guide. You do not need to install Python separately — uv handles that.

1

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.

2

Scan it with your iPhone

In the Vaultbeat app, open Settings → Data & AI → Connect an AI server. 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.

3

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?”

No app yet?

This page pairs a computer with the Vaultbeat iOS app. The app is the part that reads Apple Health and encrypts it on your iPhone before anything leaves the device — without it there is nothing to pair to.

Get Vaultbeat on the App Store

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, and re-pairing means setting your AI connection up again for nothing. The full guide has a built-in self-check that walks the whole chain, or email support@vaultbeat.app.