# Mirroir MCP

> Mirroir MCP is an open-source MCP server for developer tools. Let an agent drive your real iPhone through macOS iPhone Mirroring, no Xcode needed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, iOS, CLI
- **Repository:** https://github.com/jfarcand/mirroir-mcp
- **MCP Registry name:** io.github.jfarcand/mirroir-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

Mirroir works through the iPhone Mirroring feature of macOS, so it needs no Developer Mode, Xcode, WebDriverAgent or jailbreak and can reach any app on the phone, including App Store apps you could never build. The agent uses apps you are already signed in to, so no connector, OAuth or password is handed to anyone. Taps, typing and swipes reach the mirror without bringing it to the front, and drags and two-finger gestures bring it forward briefly.

Beyond screen control, an agent can read the screen with `describe_screen`, hear what the phone plays with `listen` (transcribed on the Mac, macOS 26 required) and replay proven sequences with `run_steps`. `generate_skill` explores an app and writes a SKILL.md of numbered steps matched on screen text, which can replay from the CLI with `mirroir test` and no LLM, so CI runs are deterministic and cost no tokens. Game support has a frame, token and time budget, and a run that exhausts it is inconclusive rather than a silent pass.

It needs macOS 15 or later and an iPhone connected via iPhone Mirroring, installs with npx or Homebrew, and the README lists 42 tools. The README compares itself to phone-harness, mobile-mcp and Appium and notes it has no Android or simulator support.

## Features

- **Stock iPhone control:** Drives the phone via iPhone Mirroring with nothing installed on the device.
- **Screen reading:** describe_screen reads what is on screen; listen transcribes phone audio on the Mac.
- **Replayable skills:** Compile explored workflows into SKILL.md files that replay without an LLM.
- **Batch steps:** run_steps replays proven sequences in one call, checked against the permission policy first.
- **Agent notes:** save_note and get_notes carry lessons per app between sessions.
- **Remote serving:** mirroir-mcp serve exposes MCP over HTTP on 127.0.0.1 behind a bearer token.
- **Game scenes:** Frame-budgeted scene steps for tap-driven and turn-based games.

## Good for

- Turn a saved recipe reel into a Reminders grocery list
- Carry a commute time from Waze into a Slack message
- Test an Expo Go login screen on a real device
- Replay a regression flow in CI without an LLM
- Script a repeated task across several phone apps

## Install

### Claude Code (Terminal)

```sh
claude mcp add mirroir-mcp -- npx -y mirroir-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mirroir-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mirroir-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mirroir-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mirroir-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mirroir-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mirroir-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mirroir-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mirroir-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mirroir-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mirroir-mcp"
      ]
    }
  }
}
```

## Tools

- `describe_screen`: Read what the iPhone screen shows.
- `listen`: Turn audio the phone plays into text, transcribed on the Mac.
- `run_steps`: Replay a proven sequence of steps in one call.
- `generate_skill`: Explore an app and write SKILL.md files for it.
- `save_note`: Keep one line per lesson per app.
- `get_notes`: Return saved notes to the next session.

## FAQ

### What do I need?

macOS 15 or later and an iPhone connected through iPhone Mirroring. Install with npx -y mirroir-mcp install or Homebrew.

### Does it need Developer Mode or Xcode?

No. The README says no Developer Mode, Xcode, WebDriverAgent or jailbreak.

### Does it support Android?

No. Android and the iOS Simulator are not supported.

### Can it play twin-stick games?

No. iPhone Mirroring exposes a single pointer, so twin-stick games stay out of reach.

### Is Mirroir MCP free?

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

### How do I add Mirroir MCP to Claude Code?

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

### What are the best alternatives to Mirroir MCP?

The closest alternatives to Mirroir MCP 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/mirroir-mcp
