mirroir-mcp

Let your agent use your real iPhone.

A personal agent, a game player, and automation that replays without an LLM. No Developer Mode, no connector, no password handed to anyone.

Watch the demoInstallView on GitHub

Needs macOS 15 or later and iPhone Mirroring.

Real runs on a real iPhone

Like mirroir-mcp? Star us on GitHub ★

Three ways to use it

Your personal agent

Errands across the apps already signed in on your phone. It reads the screen and listens: a saved recipe reel becomes a grocery list. No connector, no password handed to anyone.

Details on GitHub

Games

It plays turn-based and tap-driven games, frame by frame, under a budget. With Stockfish choosing the moves, it beat Chess.com's strongest bot.

Details on GitHub

Automation

A flow that worked becomes a skill that replays without an LLM. mirroir-run runs it in CI with the web and your API, and flags drift.

Details on GitHub

A skill is a short Markdown file

---
name: Set Timer
app: Clock
---

## Steps

1. Launch **Clock**
2. Tap "Timer"
3. Tap "Start"
4. Verify "Pause" is visible

Steps match text on screen, not coordinates. Once compiled, mirroir test replays it without an LLM. The full skill · More skills

Install v0.49.0

Paste this into your coding agent:

Set up mirroir-mcp so you can drive my iPhone: follow https://github.com/jfarcand/mirroir-mcp/blob/main/docs/onboarding.md step by step, and finish by reading back what my iPhone screen shows.

Or install it yourself:

$ brew tap jfarcand/tap && brew install mirroir-mcp
$ npx -y mirroir-mcp install
$ /bin/bash -c "$(curl -fsSL https://mirroir.dev/get-mirroir.sh)"

Claude Desktop: download the extension and double-click it.

Claude Code plugin, Hermes Agent: every install option.

Safety

Security model

FAQ

Does it work with any iPhone app?

Yes. If iPhone Mirroring shows it, your agent can use it.

Will it take over my Mac?

No. Taps and typing reach the phone while you keep working; a swipe moves the pointer for a moment.

Does my phone's audio leave my Mac?

No. macOS transcribes it on the Mac. Screenshots go to the model that runs your agent.

Which agents work with it?

Any MCP client: Claude Code, Codex, Cursor, Claude Desktop, Hermes and more.

Full FAQ