What you need
An iPhone with Apple Health records, the telo app from the App Store, and an OpenClaw installation with MCP support. In telo, sign in and send your history; the first sync must finish before OpenClaw can read anything.
The commands below follow the OpenClaw MCP documentation for remote Streamable HTTP servers with OAuth. They are not a claim that every OpenClaw version has been tested with telo.
Add the Apple Health MCP server to OpenClaw
Stop the OpenClaw Gateway first: add and login refuse to run while a Gateway owns the state directory. The first command saves the server under mcp.servers. The second opens a telo page in your browser, where you enter your email, type the 6-digit code and approve access.
Do not add an Authorization header to the config. With auth set to oauth, OpenClaw ignores static headers and keeps the token in its own state.
openclaw mcp add telo --url https://telo.health/mcp --transport streamable-http --auth oauth
openclaw mcp login teloOr install the telo skill from ClawHub
The skill telo-apple-health, published by @telo-inc, carries the same setup steps plus two guided workflows: a weekly health review and long-term trends. It contains Markdown instructions only, with no scripts, packages or environment variables.
The skill does not connect the server by itself. Run the add and login commands above once.
clawhub install telo-apple-healthCheck that OpenClaw can read Apple Health
- Run openclaw mcp doctor telo --probe, then start the Gateway again.
- If openclaw mcp status --verbose reports authorization-required, run openclaw mcp login telo again.
- Ask OpenClaw to use telo to list available metrics and the dates they cover.
- Confirm the answer comes from a telo tool call with real dates. If it describes data without calling a tool, it is guessing.
Live sync or an exported file?
A local export keeps the records on your machine, which some people prefer. The cost is a snapshot that ages from the moment you export it, and a package you should audit before giving it your health history. telo trades that for a synced copy held by the telo service.
| Apple Health export plus local MCP | telo remote MCP | |
|---|---|---|
| How records arrive | You export from the iPhone and copy the file to the computer | The iPhone app syncs in the background |
| Freshness | As old as the last export | Recent days are re-sent on every sync |
| What runs on your computer | An MCP server process, usually an npm package | Nothing; OpenClaw calls https://telo.health/mcp |
| Sign-in | File path in the config | OAuth, revocable with openclaw mcp logout telo |
| Where the data lives | Your computer | telo, until you delete the account in the app |
A first prompt
Asking for coverage first keeps gaps visible. A missing day is unavailable, not zero, and telo returns local timestamps that should not be converted to UTC.
Use telo to check which Apple Health metrics are available and how recent they are. Then compare my sleep and resting heart rate over the last 7 days with the 7 days before, and list the dates with missing records.Troubleshooting
If add or login refuses to run, the Gateway is still running. If login completes but tools fail with authorization-required, log in again; tokens are stored in OpenClaw state, not in the config.
If the connection works but records are missing, check the sync in the telo app. A working MCP connection does not prove that HealthKit read permissions were granted on the iPhone.
Practical questions
Can OpenClaw read Apple Health on its own?
No. Apple Health lives on the iPhone and has no MCP server of its own. OpenClaw needs an MCP source: a local server that reads an exported file, or a remote server such as telo, which receives the data from the iPhone app.
Do I need to export Apple Health to use it with OpenClaw?
Not with telo. The iPhone app syncs in the background and OpenClaw queries https://telo.health/mcp. An export is only needed for options that read a local file, and then the data is only as recent as the last export.
Does the ClawHub skill run code on my computer?
The telo-apple-health skill contains Markdown instructions only, with no scripts, packages or environment variables. Queries are answered by the telo remote MCP server after OAuth sign-in.
How do I remove OpenClaw access?
Run openclaw mcp logout telo to delete the token, or openclaw mcp unset telo to remove the server. To delete the account and all its data, use the Account tab in the telo app.
Sources and availability
Plans, regions and interfaces can change. Check the official sources before setting up.
How this guide was prepared
Prepared with AI assistance using the cited official documentation and the telo workflow described in the project. Screens and permissions can vary by account. This review did not include a complete authenticated test in each assistant.