
mirroir
Registers the mirroir MCP server (npx -y mirroir-mcp): screenshot, OCR, tap, swipe and type on a real iPhone through macOS iPhone Mirroring.
- GitHub stars
- 365
Install
/plugin install mirroir@mirroirRun it inside Claude Code after adding the marketplace with /plugin marketplace add jfarcand/mirroir-mcp.
Contents
Discovered from sourceAgents 1
mirroir
Let Claude use your real iPhone through macOS iPhone Mirroring, then replay what it did without an LLM. Claude reads the screen with on-device OCR, taps, swipes, types and opens apps. The phone stays stock: no Developer Mode, no Xcode, no jailbreak, and nothing to install on it.
Install
/plugin install mirroir --marketplace jfarcand/mirroir-mcp
Requirements
- macOS 15 or later, with an iPhone connected through iPhone Mirroring
- Node.js, because the plugin starts the server with
npx - Screen Recording and Accessibility permissions for the app that runs the server; macOS asks on first use
Allow it to act on the phone
The server fails closed. Until you allow more, Claude only gets read-only tools such as describe_screen, screenshot and status. To let it act, create ~/.mirroir-mcp/permissions.json:
{
"allow": ["tap", "swipe", "type_text", "launch_app"],
"blockedApps": ["Your Bank"]
}
Once tools that act are allowed, Claude can tap and type in any app you have not blocked, including messages and payments. Claude is told to ask you before sending, buying, deleting or changing a setting. The kill switch is quitting iPhone Mirroring, unlocking the iPhone, locking the Mac's screen, or quitting Claude; an app you quit is never reopened for the agent. See Permissions and Security.
What it runs, sends and fetches
- Runs:
npx -y mirroir-mcp@<version>, pinned to the plugin's version. It starts one local process that talks to Claude over stdin and stdout and opens no network port. - Downloads: npm fetches the package, whose install step downloads the matching prebuilt binary from this project's GitHub releases.
- Update check: at most once a day it asks
registry.npmjs.orgfor the newest version. Turn this off withupdateCheck: falsein the settings. - Sends to Claude: screenshots and screen text you ask it to read. These can show whatever is on your phone, so close anything you would not share.
- Optional, off until you configure it: some features, such as playing a game from screenshots, can call an AI provider you set up, such as Anthropic or OpenAI, and send it screenshots and screen text. An element-detection model is downloaded only from a URL you set.
- Stores: settings, skills, the update-check result and any models in
~/.mirroir-mcp. There are no accounts and no analytics.
Learn more
Documentation · Website · Issues · Privacy
Licensed under Apache-2.0.
MCP servers 1
Sponsors
Details
- Marketplace
- jfarcand/mirroir-mcp
- Source
- plugins/mirroir
- Category
- Automation