The iOS Simulator MCP server allows interaction with iOS simulators to perform UI automation tasks, including:
Get the ID of the currently booted iOS simulator
Describe accessibility elements on the screen
Tap on specific screen coordinates
Input text into the simulator
Swipe between coordinates
Get information about UI elements at specific locations
Take screenshots or record videos of the simulator screen
Integrates with Facebook's IDB tool to communicate with and control iOS simulators, enabling the MCP server to perform UI automation tasks.
Provides tools for interacting with iOS simulators, including getting simulator information, controlling UI interactions (tapping, swiping, text input), and inspecting UI elements for accessibility testing and automation.
Enables operation on macOS systems where iOS simulators run, providing simulator access and control capabilities specific to the macOS environment.
Utilizes Xcode's iOS simulator infrastructure to enable UI automation, testing, and interaction with simulated iOS devices.
iOS Simulator MCP Server
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 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 - Anthropic's engineering blog showcasing best practices
- React Native Newsletter Issue 187 - Featured in the most popular React Native community newsletter
- Mobile Automation Newsletter - #56 - Featured a long running newsletter about mobile testing and automation resources
- punkeye/awesome-mcp-server listing - 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
ui_describe_all
Description: Describes accessibility information for the entire screen in the iOS Simulator
Parameters:
ui_tap
Description: Tap on the screen in the iOS Simulator
Parameters:
ui_type
Description: Input text into the iOS Simulator
Parameters:
ui_swipe
Description: Swipe on the screen in the iOS Simulator
Parameters:
ui_describe_point
Description: Returns the accessibility element at given co-ordinates on the iOS Simulator's screen
Parameters:
ui_view
Description: Get the image content of a compressed screenshot of the current simulator view
Parameters:
screenshot
Description: Takes a screenshot of the iOS Simulator
Parameters:
record_video
Description: Records a video of the iOS Simulator using simctl directly
Parameters:
stop_recording
Description: Stops the simulator video recording using killall
Parameters: No Parameters
💡 Use Case: QA Step via MCP Tool Calls
This MCP server allows AI assistants integrated with a Model Context Protocol (MCP) client to perform Quality Assurance tasks by making tool calls. This is useful immediately after implementing features to help ensure UI consistency and correct behavior.
How to Use
After a feature implementation, instruct your AI assistant within its MCP client environment to use the available tools. For example, in Cursor's agent mode, you could use the prompts below to quickly validate and document UI interactions.
Example Prompts
- Verify UI Elements:
- Confirm Text Input:
- Check Tap Response:
- Validate Swipe Action:
- Detailed Element Check:
- Show Your AI Agent the Simulator Screen:
- Take Screenshot:
- Record Video:
- Stop Recording:
Prerequisites
- Node.js
- macOS (as iOS simulators are only available on macOS)
- Xcode and iOS simulators installed
- Facebook IDB tool (see install guide)
Installation
This section provides instructions for integrating the iOS Simulator MCP server with different Model Context Protocol (MCP) clients.
Installation with Cursor
Cursor manages MCP servers through its configuration file located at ~/.cursor/mcp.json
.
Option 1: Using NPX (Recommended)
- Edit your Cursor MCP configuration file. You can often open it directly from Cursor or use a command like:
- Add or update the
mcpServers
section with the iOS simulator server configuration:Ensure the JSON structure is valid, especially ifmcpServers
already exists. - Restart Cursor for the changes to take effect.
Option 2: Local Development
- Clone this repository:
- Install dependencies:
- Build the project:
- Edit your Cursor MCP configuration file (as shown in Option 1).
- Add or update the
mcpServers
section, pointing to your local build:Important: Replace/full/path/to/your/
with the absolute path to where you cloned theios-simulator-mcp
repository. - Restart Cursor for the changes to take effect.
Installation with Claude Code
Claude Code CLI can manage MCP servers using the claude mcp
commands or by editing its configuration files directly. For more details on Claude Code MCP configuration, refer to the official documentation.
Option 1: Using NPX (Recommended)
- Add the server using the
claude mcp add
command: - Restart any running Claude Code sessions if necessary.
Option 2: Local Development
- Clone this repository, install dependencies, and build the project as described in the Cursor "Local Development" steps 1-3.
- Add the server using the
claude mcp add
command, pointing to your local build:Important: Replace/full/path/to/your/
with the absolute path to where you cloned theios-simulator-mcp
repository. - Restart any running Claude Code sessions if necessary.
Configuration
Environment Variables
Variable | Description | Example |
---|---|---|
IOS_SIMULATOR_MCP_FILTERED_TOOLS | A comma-separated list of tool names to filter out from being registered. | screenshot,record_video,stop_recording |
IOS_SIMULATOR_MCP_DEFAULT_OUTPUT_DIR | Specifies a default directory for output files like screenshots and video recordings. If not set, ~/Downloads will be used. This can be handy if your agent has limited access to the file system. | ~/Code/awesome-project/tmp |
Configuration Example
MCP Registry Server Listings
License
MIT
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Enables interaction with iOS simulators by providing tools to inspect UI elements, control UI interactions, and manage simulators through natural language commands.
Related MCP Servers
- AsecurityAlicenseAqualityA bridge between iOS simulators and the Model Context Protocol, enabling programmatic control of iOS simulators through standardized communication interfaces.Last updated -1231TypeScriptMIT License
- AsecurityAlicenseAqualityA MCP server that enables LLMs to interact with iOS simulators through natural language commands.Last updated -233Apache 2.0
- AsecurityAlicenseAqualityProvides programmatic access to Xcode functionality, enabling AI assistants to create, build, test, and manage iOS/macOS projects directly.Last updated -27122MIT License