Skip to content
MCP server

StupidMirror

Let Claude Code or Codex tap, type and verify on a real iPhone or Android device

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "stupidmirror": {
      "command": "npx",
      "args": [
        "-y",
        "stupidmirror-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "stupidmirror": {
      "command": "npx",
      "args": [
        "-y",
        "stupidmirror-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers