Skip to content
MCP server

simulator-use

Build, run and tap through the iOS Simulator from a coding agent

Runs locallyStatus and history
Pricing
Open source
Platforms
macOS, CLI, iOS
Runs
Locally
Version
0.16.0
Listing updated
3 days ago

About simulator-use

simulator-use is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Rather than screenshots, the agent reads the screen as a few lines of text and taps or fills fields by label or id. A sample sign-in screen costs about 70 tokens, against roughly 40,000 for the full accessibility tree. One engine per Simulator keeps input, accessibility and screen buffer open between calls.

Steps such as tapping, filling, scrolling, swiping and waiting go through one action tool that answers with what changed and checks typed text by reading it back. Other tools build and launch Xcode projects with file:line errors, run XCTest and XCUITest cases, and handle installs, deep links, permissions, location, push and logs.

It runs on a Mac with Xcode and Node 20, and nothing leaves the machine unless you enable cloud mode. Without a Mac, a cloud iPhone run by NoMac is billed per minute.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "simulator-use": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "simulator-use": {
      "command": "npx",
      "args": [
        "-y",
        "simulator-use"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

ui_look
Reads the current screen as text.
ui_act
Runs tap, fill, scroll, swipe and wait steps and reports what changed.
screenshot_file
Saves the screen at full resolution as a PNG.

What it does

Screen as text
Compact output instead of screenshots.
Tap by label
Interact using labels and ids.
Xcode build and run
Builds projects and reports errors as file:line.
Test runner
Runs XCTest and XCUITest case by case.
Cloud iPhone option
Use a remote Simulator from Linux, Windows or CI.

Good for

  • Let an agent verify a UI change in the Simulator
  • Reproduce a sign-in failure and read the log
  • Run unit tests from a coding session
  • Test pull requests on a cloud phone in CI

Pricing

Open source

Free and open source; optional cloud phone billed per minute

Prices change. Check simulator-use.dev before you buy.

simulator-use FAQ

What does it need locally?

A Mac with Xcode and Node 20.

Is it free?

The site calls it free and open source; cloud use is billed per minute with no subscription.

Does data leave my Mac?

Not unless you turn on cloud.

Which clients work?

Claude Code, Codex, Cursor or any MCP client.

Is simulator-use free?

Yes. simulator-use is open source, so you can use and self-host it for free.

How do I add simulator-use to Claude Code?

Run this command in your terminal: claude mcp add simulator-use -- npx -y simulator-use

What are the best alternatives to simulator-use?

The closest alternatives to simulator-use are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to simulator-use

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools