Skip to content

iOS Simulator MCP and API

iOS Simulator exposes local simulator controls, screenshots and interactions through an MCP server. An agent can inspect and interact with an iOS Simulator for application checks. Longwave installs the iOS Simulator MCP server and runs it on your machine, with no account or key.

Add to Longwave

Install elsewhere

Install iOS Simulator

Choose a harness. These instructions start the same local MCP server shown on this page.

Claude Code

Run this in your terminal. It adds a user-scoped server; use --scope project instead if it should apply only to the current project.

terminal
claude mcp add --scope user --transport stdio ios-simulator -- npx -y ios-simulator-mcp
functions
17
access
Runs locally

Use iOS Simulator on Longwave

  1. Download Longwave or open app.longwave.run.
  2. Longwave installs the iOS Simulator MCP server and runs it on your machine, with no account or key.
  3. Ask for the result in any thread, for example: “Capture an iOS screen for a bug report”. The agent picks the iOS Simulator function and calls it.

iOS Simulator functions

Function
get_booted_sim_id Get the ID of the currently booted iOS simulator
install_app Installs an app bundle (.app or .ipa) on the iOS Simulator
launch_app Launches an app on the iOS Simulator by bundle identifier
list_apps Lists all installed apps on the iOS Simulator with their bundle identifiers and display names
open_simulator Opens the iOS Simulator application
open_url Opens a URL in the iOS Simulator, useful for testing deep links and universal links
record_video Records a video of the iOS Simulator using simctl directly
screenshot Takes a screenshot of the iOS Simulator
stop_recording Stops the simulator video recording using killall
terminate_app Terminates a running app on the iOS Simulator by bundle identifier
ui_describe_all Describes accessibility information for the entire screen in the iOS Simulator
ui_describe_point Returns the accessibility element at given co-ordinates on the iOS Simulator's screen
ui_find_element Searches the accessibility tree and returns elements matching the given criteria
ui_swipe Swipe on the screen in the iOS Simulator
ui_tap Tap on the screen in the iOS Simulator
ui_type Input text into the iOS Simulator
ui_view Get the image content of a compressed screenshot of the current simulator view

Use cases

Questions people ask

Does the iOS Simulator MCP server need Xcode?

The server uses Apple simulator tools on macOS. Its setup requires Xcode and the associated command-line tools. iOS Simulator documentation

Can the iOS Simulator server capture screenshots?

The listed server exposes a screenshot tool. It also includes tools for installing and launching apps in a simulator. iOS Simulator documentation

How do I add the iOS Simulator MCP server to Claude Code?

Run claude mcp add ios-simulator -- npx -y ios-simulator-mcp in a terminal. Longwave installs the iOS Simulator MCP server and runs it on your machine, with no account or key.

Who publishes the iOS Simulator MCP server?

Joshua Yoes publishes the iOS Simulator MCP server that Longwave installs. Source code

Use iOS Simulator in Longwave

Call iOS Simulator from any agent thread, on your machine or in the cloud.

Add to Longwave