Skip to content
MCP server

Mirroir MCP

Let an agent drive your real iPhone through macOS iPhone Mirroring, no Xcode needed

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

Similar MCP servers

About Mirroir MCP

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

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.

Install

Run in a terminal

claude mcp add mirroir-mcp -- npx -y mirroir-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

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

Tools this server provides (6)

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

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.

What it does

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

Pricing

Open source

Free; install with npx or Homebrew

Mirroir MCP 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.

How AIPoweredBot checks servers