iOS Simulator MCP Server: Setup for Claude, Cursor and Other Apps

• Finds the simulator that is running

  Returns the ID of the iOS simulator that is currently booted, so other tools know which one to control.

  Try: “Which simulator is running right now?”

  Read · get_booted_sim_id

• Opens the Simulator app

  Launches the iOS Simulator application on your Mac.

  Try: “Open the iOS Simulator.”

  Runs code · open_simulator

• Reads out everything on the simulator screen

  Returns accessibility information for the whole screen, such as each element, its label and where it sits.

  Try: “What is on the simulator screen right now?”

  Read · ui_describe_all

• Taps a spot on the screen

  Taps at the x and y position you give, and can hold the press for a set time.

  Try: “Tap the Sign In button.”

  Write · ui_tap

• Types text into the focused field

  Enters up to 500 characters. The default method presses US keyboard keys, and a paste method handles other keyboard layouts and non-ASCII text.

  Try: “Type my test email into the login field.”

  Write · ui_type

• Swipes across the screen

  Swipes from one point to another, with a set duration and step size.

  Try: “Swipe up to scroll the list.”

  Write · ui_swipe

• Tells what element is at a point

  Returns the accessibility element at the x and y position you give.

  Try: “What is at position 200, 400?”

  Read · ui_describe_point

• Finds screen elements by label or ID

  Searches the accessibility tree for elements whose label or ID matches your search, and can filter by type such as Button.

  Try: “Find the Settings button on screen.”

  Read · ui_find_element

• Takes a compressed look at the screen

  Returns a compressed screenshot of the current simulator view as an image.

  Try: “Show me what the simulator looks like now.”

  Read · ui_view

• Saves a screenshot to a file

  Takes a screenshot of the simulator and saves it to a path you name, as png, jpeg, tiff, bmp or gif.

  Try: “Take a screenshot and save it to my Downloads folder.”

  Files · screenshot

• Starts recording the simulator screen

  Records the simulator display to a video file with h264 or hevc. Without a path it uses the default output folder, which is Downloads unless you change it.

  Try: “Start recording a video of this flow.”

  Write · record_video

• Stops the screen recording

  Ends the video recording that is running.

  Try: “Stop recording.”

  Runs code · stop_recording

• Installs an app on the simulator

  Installs an .app or .ipa file from a path on your Mac onto the simulator.

  Try: “Install the build at ~/Builds/MyApp.app.”

  Write · install_app

• Starts an app by its bundle ID

  Launches an installed app, can restart it first, and can pass it environment variables.

  Try: “Launch com.example.app and restart it if it is running.”

  Runs code · launch_app

• Stops a running app

  Quits an app by bundle ID, useful for testing a cold start or crash recovery.

  Try: “Quit com.example.app.”

  Runs code · terminate_app

• Opens a web link or deep link in the simulator

  Opens an https address in Safari, or a custom scheme or universal link in the app that handles it.

  Try: “Open myapp://profile/42 in the simulator.”

  Runs code · open_url

• Lists apps installed on the simulator

  Returns every installed app with its bundle ID and display name, sorted by name.

  Try: “Which apps are installed on the simulator?”

  Read · list_apps

Watch out for

• It acts on the simulator like a user

  It can tap, type and swipe in whatever app is on screen, including any account you are signed in to there. Use a test account. github.com

• It writes screenshots and videos to disk

  Output goes to the path you give, or to Downloads unless you set a default folder. Check paths before approving. github.com

• It installs apps from paths you give

  The install tool takes an app bundle or .ipa from your Mac. Only point it at builds you trust. github.com

• Older versions had a command injection bug

  The README says versions before 1.3.3 had command injection flaws, fixed since. Run the current version. github.com

Security advisories