ios-agent MCP Server

by emazaheriio.github.emazaheri/ios-agentv0.6.0

Drive an iPhone or iOS Simulator via XCUIAutomation and WebDriverAgent, with compact screen digests and confirmation before destructive actions.

1Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install ios-agent MCP server

claude mcp add ios -- uvx ios-mcp

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ios": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ios-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

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

Add to ~/.codeium/windsurf/mcp_config.json.

Variable	Required	Secret	Description
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.