Mirroir
MCP server for controlling a real iPhone via macOS iPhone Mirroring...and any MacOs app. Screenshot, tap, swipe, type — from any MCP client.
What is Mirroir?
Mirroir is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for controlling a real iphone via macos iphone mirroring...and any macos app. screenshot, tap, swipe, type — from any mcp client.
MCP server for controlling a real iPhone via macOS iPhone Mirroring...and any MacOs app. Screenshot, tap, swipe, type — from any MCP client.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for controlling a real iPhone via macOS iPhone Mi
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mirroirConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mirroir
Mirroir is a macOS MCP server that gives AI assistants direct control over a real iPhone through the native iPhone Mirroring feature introduced in macOS 15 Sequoia. It exposes 33 tools covering screenshots, tap, swipe, type, key presses, app launching, scrolling, and network toggling so that any MCP client can automate real mobile device interactions without a simulator. Developers and QA engineers can write AI-driven test scripts, explore unfamiliar apps autonomously, or send messages hands-free — all using natural language prompts directed at an actual iPhone.
Prerequisites
- macOS 15 (Sequoia) or later
- iPhone signed in to the same Apple ID and connected via iPhone Mirroring
- Screen Recording and Accessibility permissions granted to the terminal/MCP client (prompted on first run)
- Node.js (for npx install) OR Homebrew installed on macOS
- An MCP client such as Claude Desktop, Claude Code, VS Code, or Cursor
Install Mirroir
Choose your preferred installation method. The curl installer is fastest; npx and Homebrew are also supported.
# Curl (recommended)
/bin/bash -c "$(curl -fsSL https://mirroir.dev/get-mirroir.sh)"
# NPX
npx -y mirroir-mcp install
# Homebrew
brew tap jfarcand/tap && brew install mirroir-mcpEnable iPhone Mirroring on macOS
Open iPhone Mirroring from the macOS Applications folder or Spotlight. Your iPhone must be nearby, unlocked, and signed in with the same Apple ID as your Mac. Keep the iPhone Mirroring window visible — Mirroir captures it for screenshot and interaction.
Grant required permissions
On first run, macOS will prompt for Screen Recording and Accessibility permissions. Grant both in System Settings > Privacy & Security. Without these, screenshot and tap tools will fail silently.
Configure your MCP client
Add Mirroir to your MCP client config. Below is the Claude Desktop / Claude Code configuration.
{
"mcpServers": {
"mirroir": {
"command": "npx",
"args": ["-y", "mirroir-mcp"]
}
}
}Verify the connection
Restart your MCP client and ask it to take a screenshot of the iPhone screen. The tool should return an image of whatever is currently displayed in the iPhone Mirroring window.
Mirroir Examples
Client configuration
Claude Desktop config for Mirroir using npx. No API keys are required; permissions are handled by macOS.
{
"mcpServers": {
"mirroir": {
"command": "npx",
"args": ["-y", "mirroir-mcp"]
}
}
}Prompts to try
Natural-language commands that Mirroir can execute against the mirrored iPhone.
- "Take a screenshot of my iPhone and describe what's on screen."
- "Open the Messages app and send 'running 10 min late' to Alice."
- "Open Calendar and create a new event called 'Dentist' next Tuesday at 2pm."
- "Scroll down in the current app and tell me what you see."
- "Launch the Settings app and navigate to Wi-Fi settings."Troubleshooting Mirroir
Screenshot tool returns an error or blank image
Ensure Screen Recording permission is granted for your terminal app or MCP client in System Settings > Privacy & Security > Screen Recording. Also confirm the iPhone Mirroring window is open and not minimized — Mirroir captures that specific window.
Tap and swipe actions have no effect on the iPhone
Check that Accessibility permission is granted. Open System Settings > Privacy & Security > Accessibility and enable the terminal/app running the MCP server. Also make sure your iPhone screen is unlocked and not showing a prompt that blocks input.
'npx -y mirroir-mcp' fails with a network error
Verify Node.js is installed with 'node --version'. If behind a corporate proxy, set the HTTPS_PROXY environment variable before running npx. Alternatively, use the Homebrew install: 'brew tap jfarcand/tap && brew install mirroir-mcp'.
Frequently Asked Questions about Mirroir
What is Mirroir?
Mirroir is a Model Context Protocol (MCP) server that mcp server for controlling a real iphone via macos iphone mirroring...and any macos app. screenshot, tap, swipe, type — from any mcp client. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Mirroir?
Follow the installation instructions on the Mirroir GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Mirroir?
Mirroir works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Mirroir free to use?
Yes, Mirroir is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Mirroir Alternatives — Similar Browser Automation Servers
Looking for alternatives to Mirroir? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Mirroir in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Mirroir?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.