Claude uses my iPhone: the mirroir-mcp setup
A free, open-source tool that lets Claude see your iPhone screen, open apps, tap, swipe and type, through the iPhone Mirroring app on your Mac. The setup, the safety settings and the prompts from my reel.
- What you need
- Mac + iPhone
- To install
- 1 command
- Until you allow more
- Read-only
Set it up
The way I'd do it. The installer adds mirroir to Claude Code for you.
You have Claude Code on a Mac, and Node.js installed (that gives you npx).
- 1
Check your Mac and iPhone
This only works through Apple's iPhone Mirroring app, so you need what it needs: a Mac on macOS 15 (Sequoia) or later, with Apple silicon or a T2 chip; an iPhone on iOS 18 or later with a passcode; both signed in to the same Apple Account, with Wi-Fi and Bluetooth on. iPhone Mirroring isn't available in the European Union.
- 2
Connect iPhone Mirroring
Open the iPhone Mirroring app on your Mac and follow its steps. When it's connected you see your iPhone screen in a window. Keep the iPhone locked and near the Mac: mirroring stops when you pick the phone up and unlock it.
- 3
Install with one command
Open Terminal and paste this. When it asks for your MCP client, type 1 for Claude Code. It prints "Claude Code configured." when it's done.
npx -y mirroir-mcp install - 4
Run the doctor
This checks everything and names the fix for anything missing. The first time, macOS asks for Screen Recording and Accessibility: turn both on for the app the doctor names (usually Terminal), then quit and reopen that app.
npx -y mirroir-mcp doctor - 5
Ask Claude to read your phone first
Open a new Claude Code session and start with a read-only test. If Claude tells you what's on your screen, it works.
Use mirroir to read what's on my iPhone screen right now. Don't tap or open anything.
Out of the box it can only look. The next tab is how you let it tap and type.
By default Claude only sees the 14 read-only tools. Everything that changes something on the phone stays hidden until you allow it.
Do this once, after the read-only test works.
- 1
Allow only what you need
The settings live in one file on your Mac: ~/.mirroir-mcp/permissions.json. allow is the list of actions Claude may use. Leave anything you don't need out of it.
- 2
Block Wallet and your bank apps
blockedApps is a list of app names mirroir refuses to open, even when tapping is allowed. Use the names exactly as they appear under the icons on your iPhone. Ask Claude Code to write the file for you:
Create the file ~/.mirroir-mcp/permissions.json with this, and show it to me before you save it: { "allow": ["tap", "swipe", "type_text", "press_key", "launch_app"], "blockedApps": ["Wallet", "[your bank app]", "[your payments app]"] } - 3
Know the off switch
Pick up your iPhone and unlock it, lock your Mac's screen, or quit iPhone Mirroring. Any one of these stops it straight away.
It never presses a password or Touch ID prompt for you, and it's told to ask before sending, buying, deleting or changing a setting. Still, watch the first few runs.
Same tool, different install. I haven't run this route myself; these steps are from the project's install guide.
You use the Claude desktop app on a Mac with Apple silicon.
- 1
Install the bundle
Download mirroir-mcp.mcpb from the latest release on GitHub (github.com/jfarcand/mirroir-mcp/releases) and double-click it to add it to the Claude app. It doesn't need Node.js.
- 2
Give it the two permissions
macOS asks for Screen Recording and Accessibility for mirroir-mcp (the robot icon), not for Claude. Turn on mirroir-mcp in both, then quit and reopen Claude.
- 3
Test it read-only
Start a new chat and ask Claude to read your phone screen without tapping anything. Then set up permissions.json as in the second tab.
Use mirroir to read what's on my iPhone screen right now. Don't tap or open anything.
What it can and can't do
It can
- Read your iPhone screen and tell you what's on it
- Open apps, tap, swipe, scroll and type, in the apps already signed in on your phone
- Carry something from one app to another, like adding an event or sending a message
- Work with nothing installed on the phone: no Developer Mode, no Xcode, no jailbreak
It can’t
- Work on Windows, Android, or in the EU (it needs Apple's iPhone Mirroring)
- Run while you're using your iPhone: mirroring stops when you unlock it
- Press a password or Touch ID prompt for you
- Show the iPhone's on-screen keyboard: it types like a real keyboard plugged into the phone
Things to ask it
The first two are from my reel. The others are the project's own examples. Watch what it does the first few times.
From the reel
Plain sentences. Claude works out the taps.
- Doctor appointment
Open Calendar and add a doctor appointment [tomorrow at 10 AM]. - Running late
Send Ahmad a WhatsApp: I'll be 10 minutes late.
More ideas
From the mirroir-mcp README and demos.
- New event
Open Calendar, create a new event called "Dentist" next Tuesday at 2pm. - Recipe to grocery list
Open the recipe reel I saved on Instagram, work out the ingredients and add them as a list in Reminders. - Record a walkthrough
Start recording, open Instagram, scroll the feed and open my profile, stop recording.
Nothing matches that. Try “sunset”, “anime” or “cover”.
Start here
- Open iPhone Mirroring on your Mac and connect your iPhone.
- In Terminal, run
npx -y mirroir-mcp installand pick Claude Code. - Run
npx -y mirroir-mcp doctorand turn on the two permissions it asks for. - Ask Claude to read your phone screen, without tapping.
- Create
permissions.json: allow tap and type, block Wallet and your bank apps. Then give it one small errand.
Out of the box it can only look. You decide what it’s allowed to touch.
mirroir-mcp is made by Jeanfrancois Arcand. The setup steps on this page come from the project’s own docs (November 2026). If something has changed, the install guide is the source of truth.
Straight answers
Is it free?
Yes. mirroir-mcp is open source (Apache-2.0), built by Jeanfrancois Arcand. You can read every line on GitHub.
Does it work on Windows or with an Android phone?
No. It drives the iPhone through Apple's iPhone Mirroring app, which only exists on macOS 15 and later.
Can Claude open my bank app?
Only if you let it. Out of the box it can't tap anything at all. Once you allow tapping, add your bank and payment apps to blockedApps and it refuses to open them.
Where does what it sees go?
What Claude reads from your screen goes to Claude, like anything else you share in a chat. The tool itself has no telemetry; its one network call is a daily check for updates, which you can turn off.
Why does my phone keep disconnecting?
iPhone Mirroring disconnects when you unlock the iPhone or lock the Mac. Keep the phone locked and close to the Mac while Claude works. If it still won't connect, run npx -y mirroir-mcp doctor.