Mirroir MCP
Let an agent drive your real iPhone through macOS iPhone Mirroring, no Xcode needed
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mirroir-mcp": {
"command": "npx",
"args": [
"-y",
"mirroir-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mirroir-mcp": {
"command": "npx",
"args": [
"-y",
"mirroir-mcp"
]
}
}
}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.


