Skip to main content
MCP server CX Codex

simulator-use — iOS Simulator MCP server: what it does, how to install

simulator-use — an MCP server that lets a coding agent build an Xcode project, read the iOS Simulator screen as plain text, and tap elements by their label.

MIT ★ 6 updated 2026-10-26

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add simulator-use -- npx -y simulator-use
Open on GitHub

What simulator-use does

simulator-use builds and launches an Xcode project, then turns the simulator screen into a handful of text lines instead of a full accessibility tree, so the agent can tap or type into a field by its #id or label. A tests_run tool runs unit and UI tests case by case and reports failures with file and line. The server talks to the Simulator through its own engine rather than spinning up a helper process on every call.

ui_act steps such as tap, fill, scroll, swipe and wait run in sequence, and each one is checked: typed text gets read back from the field, and a tap that produces no visible change is flagged rather than silently accepted. Web content inside UIKit apps (Capacitor, React Native's WebView) is read line by line, but pages inside a SwiftUI WebView, Safari, or in-app browsers have nothing for accessibility to read, so those screens need a screenshot and tap-by-point instead.

It needs a Mac with Xcode installed for local builds; from Linux, Windows, or a Mac without Xcode, npx simulator-use cloud start opens a cloud iPhone instead.

What it helps with

  • build and launch an Xcode project from an agent session
  • read an app screen as text instead of a screenshot
  • tap and fill fields by accessibility id rather than coordinates
  • run XCTest and XCUITest case by case with failure line numbers
  • reach a Simulator from Linux or Windows through a cloud iPhone

Example prompts for the agent

  • Build the Xcode project and show me the first screen
  • Fill #email with [email protected] and tap #signIn
  • Run the tests and tell me which ones failed

How to install simulator-use

Platform CLI

claude mcp add simulator-use -- npx -y simulator-use

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about simulator-use

How do I install simulator-use in Claude Code?

Run claude mcp add simulator-use -- npx -y simulator-use.

What does simulator-use do?

It builds and runs an iOS project through Xcode, turns the Simulator screen into text the agent can read, and lets it tap, type, and run tests by element name instead of screen coordinates.

Can simulator-use work without Xcode on a Mac?

Yes, npx simulator-use cloud start opens a cloud iPhone with Xcode, which also covers Linux, Windows, and a Mac without Xcode installed.

Similar MCP servers

All MCP servers for Mobile →

Project sponsors

Companies that keep this analytics open