Auto DMs are off for now. All my free resources are here. See all
hadibuilds
Guide 5 min read Updated 18 Nov 2026

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. 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. 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. 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. 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. 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.

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.

  1. Doctor appointment

    Open Calendar and add a doctor appointment [tomorrow at 10 AM].

  2. Running late

    Send Ahmad a WhatsApp: I'll be 10 minutes late.

More ideas

From the mirroir-mcp README and demos.

  1. New event

    Open Calendar, create a new event called "Dentist" next Tuesday at 2pm.

  2. Recipe to grocery list

    Open the recipe reel I saved on Instagram, work out the ingredients and add them as a list in Reminders.

  3. Record a walkthrough

    Start recording, open Instagram, scroll the feed and open my profile, stop recording.

Start here

  1. Open iPhone Mirroring on your Mac and connect your iPhone.
  2. In Terminal, run npx -y mirroir-mcp install and pick Claude Code.
  3. Run npx -y mirroir-mcp doctor and turn on the two permissions it asks for.
  4. Ask Claude to read your phone screen, without tapping.
  5. 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.