# SimMirror

> SimMirror is an open-source MCP server for developer tools. Drive iOS simulators, iPhones, Android devices and macOS apps from an agent, live. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, iOS, Android, CLI, self-hosted
- **Repository:** https://github.com/andrewkochulab/sim-mirror
- **MCP Registry name:** io.github.AndrewKochulab/sim-mirror
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add sim-mirror -- uvx sim-mirror
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/simmirror
