Getting Started with iOS Simulators

Getting Started with iOS Simulators

We support iOS Simulators running on MacOS through this MCP. This means that you can control a simulated iOS device, by prompting the agent to do actions on your behalf, like launching the Fitness app.

Prerequisites

Before the MCP server can control the iOS Simulator, we need to have WebDriverAgent running on a booted simulator.

1. Launch iOS Simulator on your MacOS, and boot a Simulator.

   • Note: as of current version, if MCP detects more than one Simulator, it uses only the first listed.

2. Launch WebDriverAgent on it. Here's what needs to be done:

   # close WebDriverAgent if you haven't done so already
   git clone --depth 1 https://github.com/appium/WebDriverAgent.git
   cd WebDriverAgent
   
   # start wda as an xcuitest, replace 'iPhone 16' with your simulator name
   xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination 'platform=iOS Simulator,name=iPhone 16' test

3. Now try the prompt list simulators. You should receive a message saying you have iPhone 16 simulator available for you.