StupidMirror
Let Claude Code or Codex tap, type and verify on a real iPhone or Android device
- Platforms
- macOS, iOS, Android
- Runs
- Locally
- Version
- 0.8.6
- Listing updated
- today
Similar MCP servers
About StupidMirror
StupidMirror is an MCP server for browser automation. It runs locally on your machine and is started by your AI client.
StupidMirror is a Mac app that mirrors iPhone and Android devices, simulators and emulators. Its local MCP server lets an AI agent drive them. It listens only on 127.0.0.1, and setup is a one-click Connect Claude Code or Connect Codex in the app's MCP Automation settings. In the Claude desktop app the live phone screen opens in the Browser pane beside the conversation.
The tools cover listing devices, observing the screen, tapping elements or text, typing and replacing text, opening URLs, installing apps, waiting for and asserting on-screen state, highlighting clickable elements and recording.
The site says StupidMirror embeds no model and needs no model API key.
Install
Run in a terminal
claude mcp add stupidmirror -- npx -y stupidmirror-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"stupidmirror": {
"command": "npx",
"args": [
"-y",
"stupidmirror-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"stupidmirror": {
"command": "npx",
"args": [
"-y",
"stupidmirror-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"stupidmirror": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"stupidmirror-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"stupidmirror": {
"command": "npx",
"args": [
"-y",
"stupidmirror-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"stupidmirror": {
"command": "npx",
"args": [
"-y",
"stupidmirror-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (17)
Taken from the project documentation; the running server may differ.
- list_devices
- Lists connected devices.
- observe_screen
- Reads the current screen.
- tap_element
- Taps an element.
- tap_text
- Taps visible text.
- type_text
- Types text.
- clear_text
- Clears a text field.
- replace_text
- Replaces text.
- open_url
- Opens a URL.
- install_app
- Installs an app.
- wait_for
- Waits for a screen condition.
- assert_screen
- Asserts screen state.
- find_any_element
- Finds an element.
- highlight_clickable_elements
- Highlights clickable elements.
- highlight_elements
- Highlights elements.
- show_screen
- Shows the device screen.
- start_recording
- Starts a screen recording.
- connect_control
- Connects control to a device.
What it does
- Real and virtual devices
- Controls phones, simulators and emulators.
- Live viewer
- Shows the phone screen in the Browser pane.
- Tap and type
- Interacts with elements and text.
- Assertions and waits
- Verifies on-screen state.
- Local only
- Listens on localhost.
Good for
- Test an app flow on a real iPhone
- Install a build and verify a screen
- Record a bug reproduction
- Check a mobile layout on Android
Pricing
Pricing unknown
Prices not published.
Prices change. Check stupidmirror.itool.tech before you buy.
StupidMirror FAQ
Does it need an API key?
No, it embeds no model.
Which clients connect?
Claude Code and Codex with one click; others use generated configuration.
Where does the server listen?
Only on http://127.0.0.1:<port>/mcp.
What runs it?
The StupidMirror Mac app.
How do I add StupidMirror to Claude Code?
Run this command in your terminal: claude mcp add stupidmirror -- npx -y stupidmirror-mcp
What are the best alternatives to StupidMirror?
The closest alternatives to StupidMirror are REA, Browser Use, Scrapling MCP Server, Context7 and Chrome DevTools MCP.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.


