BACK TO MCP SERVERS
dev-toolsany

Mirroir Mcp

Drive a stock iPhone via iPhone Mirroring: no Developer Mode, Xcode or WDA. LLM-free skill replay.

At a glance

Not tested yet
GitHub stars
397
Weekly downloads
3,843
Last commit
2026-11-20
Licence
Apache-2.0
Transport
stdio
Auth
none
Install
npx -y mirroir-mcp
Stats checked 2026-11-21

What it does

Mirroir Mcp is an MCP server that lets an AI agent drive a real iPhone through macOS iPhone Mirroring. It reaches any app on the phone, including App Store apps, without Developer Mode, Xcode, WebDriverAgent or a jailbreak. It uses the apps already signed in on the phone, so no connector, OAuth or password is handed to anyone. It is for people who want their agent to run errands across phone apps, build automations, or play games.

The Claude app and a real iPhone side by side: the agent asks what to play, builds a five-track Gui Boratto-style playli
Image: jfarcand/mirroir-mcp (Apache-2.0)

Tools it gives your agent

The sources name these tools and steps:

  • describe_screen: reads the frames of what is on screen.
  • listen: turns what the phone plays, such as a reel's narration or a voice message, into text.
  • touch: holds a finger for virtual joysticks.
  • hold_keys: drives games that take keyboard and mouse.
  • pinch and rotate: zoom and rotate.
  • run_steps: replays a sequence that has worked in one call.
  • generate_skill: explores an app and writes SKILL.md files.
  • save_note and get_notes: keep one line per lesson per app and give it to the next session.

Quick start

You need macOS 15 or later and an iPhone connected through iPhone Mirroring. Install it yourself, then check the setup:

npx -y mirroir-mcp install
npx -y mirroir-mcp doctor

doctor names anything left to fix. Then ask for something.

Add it to Claude Code from a terminal:

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

Or add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):

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

Environment variables

The registry entry declares no environment variables.

Example prompts

  • Open Calendar, create a new event called "Dentist" next Tuesday at 2pm.
  • Open my Expo Go app, tap "LoginDemo", test the login screen with test@example.com / password123. Screenshot after each step.
  • Start recording, open Instagram, scroll the feed and open my profile, stop recording.
  • Read the commute time in Waze, then post it in Slack.

What to watch out for

  • Without a config file, only the 14 read-only tools are exposed. Tools that change something stay hidden until you allow them in permissions.json.
  • blockedApps keeps the AI out of apps like Wallet or Banking, even when other tools are allowed.
  • It never presses a sheet that asks for a password or Touch ID, and it tells agents to ask you before sending, buying, deleting or changing a setting.
  • It runs as your user with Screen Recording and Accessibility permissions.
  • By default it makes one network call a day, a version check against npm. updateCheck: false turns it off.
  • What your agent reads from the screen goes to whichever model your client uses.
  • iPhone Mirroring exposes a single pointer, so twin-stick games stay out of reach.
  • listen needs macOS 26.
  • Android and the iOS Simulator are not supported.

Not tested by tools4agents yet. Read the source repository before you install it.

GitHub SourceGitHub Stars
Last verified 2026-11-21

Similar tools