Android Puppeteer MCP

Android Puppeteer is a lightweight, visual-first MCP (Model Context Protocol) server that enables AI agents to interact with Android devices through intelligent UI element detection and automated interactions. Built on uiautomator2, it provides comprehensive Android automation capabilities including visual element detection, touch interactions, text input, and video recording. Its 12 documented tools cover press, video.

People connecting browser automation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2025-09-18 · ★ 4 · #169 OF 196 MAINTAINED BROWSER AUTOMATION · VERIFIED 2026-08-25

Python servers · how we verify → /methodology

01 · Install Android Puppeteer MCP

Claude Code

claude mcp add pedro-rivas-android-puppeteer-mcp -- uvx android-puppeteer-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "pedro-rivas-android-puppeteer-mcp": {
      "command": "uvx",
      "args": [
        "android-puppeteer-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license no standard license detected - usage rights unclear; check the repo before commercial use

pypi package android-puppeteer-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.pedro-rivas is GitHub-verified and matches the repo owner

03 · What Android Puppeteer MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all available Android emulators and devices with their status and dimensions, get the screen dimensions of a specific Android device, get detailed information about all interactive UI elements on screen, and capture annotated screenshots with numbered UI element overlays.

Capability map

Tools grouped from the project's README - what Android Puppeteer MCP lets an agent do.

read & search

3 tools - e.g. List all available Android emulators and devices with their status and dimensions; Get the screen dimensions of a specific Android device; Get detailed information about all interactive UI elements on…

list_emulators · get_device_dimensions · get_ui_elements_info

Press

2 tools - e.g. Tap on specific coordinates with optional long press duration; Press the hardware back button

press · press_back

Take

1 tool - e.g. Capture annotated screenshots with numbered UI element overlays

take_screenshot

Long

1 tool - e.g. Perform long press gestures on specific coordinates

long_press

Swipe

1 tool - e.g. Perform directional or custom coordinate swipes

swipe

Type

1 tool - e.g. Type text into focused input fields with optional text clearing

type_text

Scroll

1 tool - e.g. Scroll specific UI elements in any direction

scroll_element

Record

1 tool - e.g. Start screen recording with customizable quality settings

record_video

Limitations (from the README)

- Device Permissions: Ensure USB debugging is enabled on target Android devices - Network Access: Some features require network connectivity for device communication - Storage: Screenshot and video files are saved locally in ss/ and videos/ directories - Performance: Response times depend on device performance and network latency

04 · Who maintains Android Puppeteer MCP

android-puppeteer-mcp is maintained by pedro-rivas. It's the only MCP server we track from this author; the repo dates to Sep 2025.

05 · Facts

repository: github.com/pedro-rivas/android-puppeteer-mcp
category: browser automation - ranked #169 of 196 actively-maintained browser automation servers as of 2026-08-25.
registry: io.github.pedro-rivas/android-puppeteer-mcp (active, first published 2025-09-18)
packages: pypi:android-puppeteer-mcp

06 · Android Puppeteer MCP FAQ

Is Android Puppeteer MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2025-09-18. We re-verify nightly.

What can Android Puppeteer MCP do?

How do I install Android Puppeteer MCP?

Run `uvx android-puppeteer-mcp`. You can also paste the ready-made client config above.

Does Android Puppeteer MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Android Puppeteer MCP

Alternatives to Android Puppeteer MCP

Maintained browser automation servers if Android Puppeteer MCP isn't the fit.

Pairs well with

Servers that cover what Android Puppeteer MCP doesn't - only shown when the pairing reason fits the companion.

More browser automation MCP servers · Vigilis · Qaskills · Uimax MCP · unbrowser by Unchained · Selenium MCP

More Python MCP servers · SentinelX MCP · Pentesttoolscom MCP Server · Perseus Ledger - verifiable, hash-chained event provenance · Perseus: MCP server and live context engine · UniFi Gateway · see all