ios-agent runs on your own machine — the client starts it, so there is no endpoint to ping. 182 installs a week from pypi. Last commit 9 Oct 2026.
Drive a real iPhone or an iOS Simulator with an AI agent, through XCUIAutomation.
We read the source, 4 d ago · rules 995398eba69f
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
_reaper = subprocess.Popen(
return dict(os.environ)
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add ios-agent -- uvx ios-mcp
{
"mcpServers": {
"ios-agent": {
"command": "uvx",
"args": [
"ios-mcp"
]
}
}
}
[mcp_servers.ios-agent]
command = "uvx"
args = ["ios-mcp"]
{
"mcpServers": {
"ios-agent": {
"command": "uvx",
"args": [
"ios-mcp"
]
}
}
}
{
"servers": {
"ios-agent": {
"type": "stdio",
"command": "uvx",
"args": [
"ios-mcp"
]
}
}
}
Optional settings from the registry entry, left out of the block above:
IOS_MCP_POLICY__CONFIRM_DESTRUCTIVE (Ask before an action that sends, deletes, or pays. Leave it on for a device carrying real accounts), IOS_MCP_POLICY__ENABLED (The policy gate as a whole: approval, app blocklist, redaction, audit), IOS_MCP_WDA__BUNDLE_ID (Bundle id of the WebDriverAgent runner. Free Apple IDs cannot sign com.facebook.*, so device builds need their own), IOS_MCP_SIMULATOR__SHOW_WINDOW (Bring Simulator.app to the front when booting, so a person can watch the agent drive. Set false in CI).
Drive the iOS Simulator from a coding agent, with every action verified.
Drive a real iPhone via macOS iPhone Mirroring; Xcode build/test automation for sims and devices.
Drive the iOS Simulator from an agent: read the screen, tap/type/swipe, replay flows in CI.
Cloud iOS simulators and Android emulators your agent can create, drive, and throw away.
Mac app that lets AI agents drive iPhones, iOS simulators and Android: tap, type, install, logs.
See any site as it looks on a real iPhone, iPad or MacBook — and drive that window over MCP.
Let AI agents read and drive a running React Native or Flutter app through Buoy's devtools.
Mirror and drive iOS Simulators and iPhones: token-efficient UI snapshots, a live viewer, recording.
Answers built from our own checks of this server.