What you need
This guide refers to OpenAI Codex, not the separate company Codex Health. You need a current Codex installation with MCP support and access to a server containing your authorised records.
For telo, you also need an invited account and a completed iPhone sync. The configuration below follows the documented Codex MCP flow; it is not a claim that every Codex version and account has been tested with telo.
Add the remote server in the CLI
The first command registers the server. The second starts the OAuth flow. Sign in with your telo account in the browser and review the requested access.
Adding the URL does not itself authorise access or upload iPhone records. Never put a login code or private token into a shared configuration file.
codex mcp add telo --url https://telo.health/mcp
codex mcp login teloCheck that the connection is usable
- Run codex mcp list to check that telo is configured.
- Open a new Codex session and ask it to use telo to list available metrics and date ranges.
- Confirm that Codex invokes a telo tool and returns actual coverage. Stop if it reports that the server is unavailable.
- For a first comparison, use a small period and ask Codex to identify missing records rather than filling gaps.
A first prompt for your records
You can ask for a table or a chart after checking the records. If you ask Codex to save an analysis, consider where the output will be stored before including personal health information in a repository.
Use telo to check the available workout records for the last 30 days. Summarise the recorded sessions by week, state the covered dates, and do not infer missing sessions.Troubleshooting authorisation
If login fails, check that the server URL is correct and your Codex version supports the server’s OAuth flow. Follow the current MCP documentation for version-specific configuration.
If the connection is authorised but records are absent, check the account and sync in telo. A successful MCP handshake does not mean that HealthKit permissions were granted on the iPhone.
Sources and availability
Plans, regions and interfaces can change. Check the official sources before setting up.
Practical questions
Does Codex inherit my ChatGPT Health connection?
No. Current documentation says Health is not supported in Codex. Configure a separate MCP source and check tool access in the session you are using.
Does mcp add upload health records?
The command registers the server address. History is uploaded by the telo iPhone app with your authorisation. Codex access requires login and approval; records are requested when a tool is used.
How can I verify a table produced by Codex?
Ask for the dates queried, the number of returned records and any gaps. Compare a small period with the source records. If the tool reports a truncated result, request smaller periods before accepting the total.
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.