Home › Development › ios-agent

ios-agent

Drive a real iPhone or an iOS Simulator with an AI agent, through XCUIAutomation.

Python Local macOS

★ 3 stars Last pushed 2026-11-01 License: MIT

View repository → Website →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

uvx ios-mcp

Or add to your MCP client config:

{
  "mcpServers": {
    "ios-agent": {
      "command": "uvx",
      "args": [
        "ios-mcp"
      ]
    }
  }
}

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.