Mirror a real iPhone over USB or Wi-Fi. Then let local OCR, Accessibility, and MCP make it operable by you and your AI agent.
Works with
01 / MIRROR
It is a mirror,
and a device operations console.
Mirroring, control, and automation no longer live in separate tools. Discovery, live video, independent windows, and AI actions all happen in one native Mac app.
A mirror built to stay live
StupidMirror uses the iPhone screen source exposed directly by macOS. Even while the iPhone camera is active, the dashboard and standalone mirror keep rendering.
Connect, trust the Mac, and the device appears.
True device proportions for debugging, capture, and demos.
Enter an SM- activation code to unlock multiple devices. No sign-in required.
Swift, AVFoundation, and CoreMediaIO — without a heavyweight browser shell.
macOS Vision OCR and iOS Accessibility replace visual guesswork with real targets.
Tap, swipe, long-press, type, and clear on iPhone or Android 11+ from an agent workflow.
ALSO ON ANDROID
Connect with USB debugging and use the same StupidMirror workspace for live mirroring, device audio, direct control, and MCP automation.
02 / WIRELESS
The built-in guide checks the device, your Apple development account, and the screen agent. After one USB setup, disconnect the cable and keep a full-resolution H.264 mirror over your LAN.
Mirroring and control stay separate. Viewing a screen never installs or starts the control path behind your back.
CODEX
Connect once. View, operate, annotate.
Open MCP Automation settings and click Connect Codex. Select StupidMirror in a new chat to open the embedded phone panel.
Local WebRTC carries the phone video into Codex. Switch devices, pause, or resume without a separate mirror window.
Enable manual control to tap and drag. AI observations keep images by default, with compact text and targeted controls.
Freeze a frame, move and resize numbered regions, then send the marked image and your note with Command-Enter. The composer stays below the picture.
Video stays local. Screenshots requested by your AI and annotations you send follow your AI client’s data settings. Host support is required for image messages.
03 / AI HARNESS
StupidMirror includes an MCP server bound to localhost. It embeds no model and asks for no model API key — it hands the real device to the Codex or Claude Code setup you already use.
Set up MCP for Claude Codeobserve_screentap_texttap_elementswipelong_press
type_textreplace_textassert_screenwait_forget_ui_tree
show_screenpress_buttonactivate_appscrollscreenshot
The latest frame, local Vision OCR, and iOS Accessibility converge on the real target.
Targets, taps, and swipe paths appear only on the Mac, ready for review or takeover.
System Settings, the App Store, dense feeds, and custom canvases all yield semantic targets.
Real screens. Real control.
Drag through the captures. Open any screen to inspect the recognized targets.
04 / PRIVACY
OCR runs on demand on your Mac. Action overlays never go back to the iPhone or into the video stream. StupidMirror embeds no model, needs no model API key, and never uploads the screen to a model service on its own.
05 / USE CASES
Debug real hardware, reproduce issues, and rerun flows without bouncing between iPhone and Mac.
Hand a real device to Codex or Claude Code through MCP for observable, verifiable workflows.
Standalone mirrors fit recording, streaming, and demos; an account-bound SM- license unlocks parallel iPhone workflows.
06 / FAQ
Yes. Run Set Up This iPhone once over USB, then keep the iPhone and the Mac on the same network and mirror it over Wi-Fi. Wireless audio is not available.
macOS exposes a USB-connected iPhone screen as a camera-style capture source. StupidMirror reads that source; it does not use the Mac webcam.
Yes. Android 11 or newer over ADB with USB debugging enabled. Video and device audio come from scrcpy, and control uses Appium with UiAutomator2.
Codex through the bundled plugin, which shows the live phone screen inside the chat, and Claude Code or other MCP clients through the local MCP server. StupidMirror needs no model API key.
No. The Codex panel streams over encrypted local WebRTC without a cloud relay, the MCP server listens on this Mac only, and text recognition runs locally with Apple Vision.
One device can be mirrored and controlled without signing in. An SM- activation code unlocks several devices at once. The source is available under PolyForm Noncommercial, and commercial use needs separate authorization.
A Mac with macOS 15 or newer. Wireless iPhone mirroring and iPhone control also need Developer Mode on the phone and an Apple Development signing identity on the Mac; simulators need Xcode.
macOS 15+ · Free for personal and noncommercial use · Commercial license required