Relay

Your agent plans your intervals. They show up on your Watch.

Relay sends your Apple Health data to the AI agent you run yourself, and schedules the running workouts it builds on your Apple Watch. Everything is encrypted on your iPhone before it leaves.

Download on the App Store Install relay-agent

Who it's for

Relay is for you if you have an iPhone, an Apple Watch and your own AI agent: Hermes, OpenClaw, Claude or ChatGPT over MCP, or any agent that can run a command. Your agent does the coaching. Relay carries the data.

Three steps

  1. Install. Install the Relay app on your iPhone and allow it to read Health. On the agent side, install the relay-agent client.
  2. Link. Run relay-agent relier. It prints an eight-character session. Enter it in the app under "Link an agent". The app and the agent show the same six-digit code: check it and confirm.
  3. Get your workouts. Your agent reads your data and plans a workout: warm-up, work and recovery blocks, target paces, cool-down. The app schedules it in the Workout app on your Watch, which shows it on the planned day.

No account, no email, no password. If your agent has no screen to compare a code, the pairing phrase in the app is the fallback.

What your agent gets

For each data type, the agent knows the time of the latest sample and of the last sync, so it knows how fresh its numbers are. It can also ask the iPhone for an immediate sync through a silent notification, as long as the iPhone is unlocked.

Encryption, plainly

On first launch, the app generates a 256-bit encryption key. The key stays in your iPhone's keychain and is never sent to the relay. The app encrypts each batch of data with AES-256-GCM, then uploads it. Only your agent, which received the key during pairing, can decrypt it.

The relay only sees technical data: a random account ID, the type and month of each batch, its size and upload time, the iPhone's notification token and the subscription end date. It sees no health values. Neither does the developer.

The relay's code is public (relay-serveur, AGPL-3.0), and so is the client's (relay-agent, MIT). The relay runs on an OVHcloud server in France. You can also host your own and enter its address in the app's settings.

Install relay-agent

On your agent's machine (Python 3):

uv tool install git+https://github.com/jStrider/relay-agent      # or: pipx install git+https://github.com/jStrider/relay-agent
relay-agent relier

The commands use French names (relier means link) and print French messages. Then, depending on your agent:

UseCommand
Files the agent readsrelay-agent sync --dest ~/relay
Dated health summaryrelay-agent resume --dest ~/relay
Plan a workoutrelay-agent seance ajouter …
MCP server (Claude, ChatGPT, Cursor)relay-agent mcp --dest ~/relay
Sandboxed agentrelay-agent pont --ecoute 172.17.0.1:8771 --dest …

The bridge (pont) runs on the host with the phrase: the agent's container holds no secret and needs no Internet access. Every command is documented in the relay-agent README.

Pricing

Reading: free Your agent reads all your data, with no time limit.
Relay Agent: €4.99 a month or €29.99 a year Workouts sent to your Watch and on-demand refresh. 14-day free trial, cancel anytime in your Apple settings.

The subscription covers the relay hosted by the developer. A relay you host yourself with RELAY_GRATUIT=1 needs no subscription.

Requirements

An iPhone on iOS 18 or later. An Apple Watch for workouts. An agent that can run a command or speak MCP.

Support

Email support@relay-agent.app, reply within 48 hours. Check the known issues first: the top one covers workouts that don't reach the Watch.