HomeDevelopment › ios-agent

ios-agent

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

Python Local macOS
★ 0 stars Last pushed 2026-09-23 License: MIT

Topics: OS Automation

Connect

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

Package (pypi 0.1.1)

uvx ios-mcp

Or add to your MCP client config:

{
  "mcpServers": {
    "ios-agent": {
      "command": "uvx",
      "args": [
        "ios-mcp"
      ],
      "env": {
        "IOS_MCP_POLICY__CONFIRM_DESTRUCTIVE": "<YOUR_VALUE>",
        "IOS_MCP_POLICY__ENABLED": "<YOUR_VALUE>",
        "IOS_MCP_WDA__BUNDLE_ID": "<YOUR_VALUE>",
        "IOS_MCP_SIMULATOR__SHOW_WINDOW": "<YOUR_VALUE>"
      }
    }
  }
}
  • 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.

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry