ios-simulator-mcp

# iOS Simulator MCP Server [](https://cursor.com/install-mcp?name=ios-simulator&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImlvcy1zaW11bGF0b3ItbWNwIl19) [](https://www.npmjs.com/package/ios-simulator-mcp) A Model Context Protocol (MCP) server for interacting with iOS simulators. This server allows you to interact with iOS simulators by getting information about them, controlling UI interactions, and inspecting UI elements. > **Security Notice**: Command injection vulnerabilities present in versions < 1.3.3 have been fixed. Please update to v1.3.3 or later. See [SECURITY.md](SECURITY.md) for details. https://github.com/user-attachments/assets/453ebe7b-cc93-4ac2-b08d-0f8ac8339ad3 ## 🌟 Featured In This project has been featured and mentioned in various publications and resources: - [Claude Code Best Practices article](https://www.anthropic.com/engineering/claude-code-best-practices#:~:text=Write%20code%2C%20screenshot%20result%2C%20iterate) - Anthropic's engineering blog showcasing best practices - [React Native Newsletter Issue 187](https://us3.campaign-archive.com/?u=78d9e37a94fa0b522939163d4&id=656ed2c2cf#:~:text=iOS%20Simulator%20MCP%20Server) - Featured in the most popular React Native community newsletter - [Mobile Automation Newsletter - #56](https://testableapple.com/newsletter/56/#:~:text=iOS-,iOS%20Simulator%20MCP,-%F0%9F%8E%99%EF%B8%8F%20Joshua%20Yoes) - Featured a long running newsletter about mobile testing and automation resources - [punkeye/awesome-mcp-server listing](https://github.com/punkpeye/awesome-mcp-servers) - Listed in one of the most popular curated awesome MCP servers collection ## Tools ### `get_booted_sim_id` **Description:** Get the ID of the currently booted iOS simulator **Parameters:** No Parameters ### `open_simulator` **Description:** Opens the iOS Simulator application **Parameters:** No Parameters ### `ui_describe_all` **Description:** Describes accessibility information for the entire screen in the iOS Simulator **Parameters:** ```typescript { /** * Udid of target, can also be set with the IDB_UDID env var * Format: UUID (8-4-4-4-12 hexadecimal characters) */ udid?: string; } ``` ### `ui_tap` **Description:** Tap on the screen in the iOS Simulator **Parameters:** ```typescript { /** * Press duration in seconds (decimal numbers allowed) */ duration?: string; /** * Udid of target, can also be set with the IDB_UDID env var * Format: UUID (8-4-4-4-12 hexadecimal characters) */ udid?: string; /** The x-coordinate */ x: number; /** The y-coordinate */ y: number; } ``` ### `ui_type` **Description:** Input text into the iOS Simulator **Parameters:** ```typescript { /** * Udid of target, can also be set with the IDB_UDID env var * Format: UUID (8-4-4-4-12 hexadecimal characters) */ udid?: string; /** * Text to input * Format: ASCII printable characters only */ text: string; } ``` ### `ui_swipe` **Description:** Swipe on the screen in the iOS Simulator **Parameters:** ```typescript { /** * Swipe duration in seconds (decimal numbers allowed) */ duration?: string; /** * Udid of target, can also be set with the IDB_UDID env var * Format: UUID (8-4-4-4-12 hexadecimal characters) */ udid?: string; /** The starting x-coordinate */ x_start: number; /** The starting y-coordinate */ y_start: number; /** The ending x-coordinate */ x_end: number; /** The ending y-coordinate */ y_end: number; /** The size of each step in the swipe (default is 1) */ delta?: number; } ``` ### `ui_describe_point` **Description:** Returns the accessibility element at given co-ordinates on the iOS Simulator's screen **Parameters:** ```typescript { /** * Udid of target, can also be set with the IDB_UDID env var * Format: UUID (8-4-4-4-12 hexadecimal characters) */ udid?: string; /** The x-coordinate */ x: number; /** The y-coordinate */ y: number; } ``` ### `ui_view` **Description:** Get the image content of a compressed screenshot of the current simulator view **Parameters:** ```typescript { /** * Udid of target, can also be set with the IDB_UDID env var * Format: UUID (8-4-4-4-12 hexadecimal characters) */ udid?: string; } ``` ### `screenshot` **Description:** Takes a screenshot of the iOS Simulator **Parameters:** ```typescript { /** * Udid of target, can also be set with the IDB_UDID env var * Format: UUID (8-4-4-4-12 hexadecimal characters) */ udid?: string; /** File path where the screenshot will be saved. If relative, it uses the directory specified by the `IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR` env var, or `~/Downloads` if not set. */ output_path: string; /** Image format (png, tiff, bmp, gif, or jpeg). Default is png. */ type?: "png" | "tiff" | "bmp" | "gif" | "jpeg";