Skip to content
MCP server

SimMirror

Drive iOS simulators, iPhones, Android devices and macOS apps from an agent, live

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, iOS, Android
Runs
Locally
Version
3.7.0
Listing updated
today

Similar MCP servers

About SimMirror

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

SimMirror streams a simulator or device into a browser tab, iframe or web component, and draws an animated cursor that shows where the agent is about to tap before it lands. People can step in at any time, since the agent waits until the user's hand is still.

To keep token use down, agents read the screen as compact accessibility snapshots with stable element refs and diffs between screens rather than screenshots. A batch action tool plays up to 20 steps and waits for text or for the screen to settle. For games and canvases it reads text from pixels with macOS Vision. An observe mode refuses taps on controls that read like Delete, Save or Send, for walkthroughs on accounts that must not be changed.

It supports real iPhones over a cable through WebDriverAgent, Android emulators and phones, and macOS apps, and can record any screen as an MP4 or GIF with touches drawn in. It needs an Apple Silicon Mac and Xcode 26 or later.

Install

Run in a terminal

claude mcp add sim-mirror -- uvx sim-mirror

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sim-mirror": {
      "command": "uvx",
      "args": [
        "sim-mirror"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sim-mirror": {
      "command": "uvx",
      "args": [
        "sim-mirror"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "sim-mirror": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "sim-mirror"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "sim-mirror": {
      "command": "uvx",
      "args": [
        "sim-mirror"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "sim-mirror": {
      "command": "uvx",
      "args": [
        "sim-mirror"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

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

sim_snapshot
Read the screen as a compact accessibility snapshot.
sim_act
Play up to 20 steps in one call with waits.
sim_device
Manage devices, for example rotate a simulator or check health.

What it does

Live viewer
H.264 or JPEG stream with touch, scroll, typing and hardware buttons.
Agent cursor
Announces and animates every gesture before it lands.
Snapshot-first reading
Compact text snapshots with stable refs and screen diffs.
Real device support
Drives iPhones over cable and Android devices.
Recording
Captures MP4 or GIF at up to 120 frames per second, optionally cropped.
Observe mode
Blocks taps on destructive-looking controls unless confirmed.

Good for

  • Have an agent walk through app sign-up and record it as a GIF
  • Check how an app reconnects after toggling airplane mode on a real iPhone
  • Read an iOS version from Settings without screenshots
  • Attach a screen recording to a pull request

Pricing

Open source

SimMirror FAQ

What hardware is required?

An Apple Silicon Mac with Xcode 26 or later, plus uv or Homebrew.

Which agents work?

Claude Code, Codex, Cursor and other MCP clients.

Can it test on a real iPhone?

Yes, with Developer Mode on and an Apple development team for touch.

How does it install?

As a Claude Code plugin, via uvx, or with uv tool or Homebrew.

Is SimMirror free?

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

How do I add SimMirror to Claude Code?

Run this command in your terminal: claude mcp add sim-mirror -- uvx sim-mirror

What are the best alternatives to SimMirror?

The closest alternatives to SimMirror are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers