Hermes iOS MCP
An iPhone app with a connector and MCP server that gives a Hermes agent location, health and activity data from the phone.
- 121 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent reads the user's location, place history and health metrics.
- `query_sensor_data` runs arbitrary SELECT queries against the sensor database, and the relay is reachable over the network.
Install
- Works in
Manual install
hermes-mobile setupRun it in the `connector` directory after `pip install -e .[dev]`: the wizard connects the relay and registers the MCP server.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent reads the user's location, place history and health metrics.
- `query_sensor_data` runs arbitrary SELECT queries against the sensor database, and the relay is reachable over the network.
This is third-party code. Review the repository files before installing.
What it does
Hermes iOS is a self-hosted companion for Hermes Agent: an iPhone app, a public relay and a connector that runs next to the Hermes runtime. The connector receives location, 11 HealthKit metrics and motion type from the phone, stores them in a local SQLite database and exposes them to the agent through the `hermes_mobile` MCP server. The server offers 8 tools: current position, location history, a health summary and per-metric time series, current activity, the database schema and read-only `query_sensor_data` queries. A separate `hermes-ios` skill teaches the agent when to call them.
Who it is for. iPhone owners who run Hermes Agent themselves and want to ask it about their movements, sleep and heart rate.
Good fit when
- Hermes picks a restaurant or route based on where the user has been today.
- The agent builds a weekly summary of steps, sleep and heart rate.
- The agent builds a personal HealthKit dashboard with SQL queries.
- A voice chat with Hermes runs from the phone, with camera frames attached.
Not a fit when
- Hermes serves several people: the sensor database is personal.
- No Mac with Xcode is at hand: you build the app yourself.
- Health data cannot be stored even on your own machine.
Example request
How many steps did I walk this week and how did I sleep the last three nights? Draw a chart.MCP
- Transport
- stdio
- Authentication
- not required
Environment variables
HERMES_COMMANDrequired- Absolute path to the hermes executable
HERMES_MOBILE_RELAY_URLrequired- Relay address including the API version
Limitations
The project is independent and not affiliated with Nous Research. You build the app in Xcode with your own signing, and install the relay and connector separately in Python. A physical iPhone cannot reach `localhost`, so use a LAN address or a public URL. Voice mode uses OpenAI Realtime, CarPlay needs Apple approval and APNs is configured separately. Schemas and settings change; the last commit was in October 2026.
How to disable. Stop the connector background service and the relay, remove the `hermes_mobile` MCP server from Hermes and delete `~/.hermes/skills/hermes-ios`. Delete `~/.hermes-mobile/sensors.db` by hand if you no longer need the data.
FAQ
Where is the phone data stored?
On the connector machine, in the SQLite file `~/.hermes-mobile/sensors.db`. The author states that the data does not leave that machine.
Which tools does the agent see?
Eight: `get_user_location`, `get_location_history`, `get_health_summary`, `get_health_metric`, `get_health_metrics_list`, `get_user_activity`, `get_sensor_schema` and `query_sensor_data`.
Are APNs and CarPlay required?
No, both are optional extras. APNs delivers replies while the app is in the background, and CarPlay needs Apple approval.
Do I need a Mac to install it?
Yes, you build the app in Xcode: pick a signing team and run it on a phone or simulator. The relay and connector run on Python.
How do I pair the phone with Hermes?
On the connector machine run `hermes-mobile pair-phone`, then scan the QR code or type the code in the app.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server that installs on a jailbroken iPhone and gives an agent 46 tools: taps, screenshots, OCR, apps, files and logs
An MCP server to drive iOS and Android: simulators, emulators and real devices via accessibility trees and screenshots
Heimdall gives an agent the whole App Store Connect and Server APIs: releases, subscriptions, reviews, TestFlight, 786 tools
Lets Claude Code and Codex drive a real iPhone: read the screen, tap, type and scroll in any app
Mobile Device MCP controls iOS and Android: taps, typing, screenshots and the element tree, with several devices at once
An app, CLI, MCP server and skill let Claude Code and Codex see and tap an unmodified iPhone, with no jailbreak and no cable.
README in short
Three parts work together: the app sends data to a relay, and the connector pulls it and runs Hermes on your machine. The `hermes-mobile setup` wizard registers the MCP server and the service.