Skip to content
MCP server

adb-mcp: Android emulator and device control over adb

Lets an agent drive Android emulators and devices over adb: inspect UI, tap, build, test

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.25.0
Listing updated
3 days ago

About adb-mcp: Android emulator and device control over adb

adb-mcp: Android emulator and device control over adb is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The server tries to remove the usual adb pitfalls. Screenshots go through exec-out screencap to avoid corrupted line endings and are downscaled so image readers accept them. The UI inspection tool reports each element's centre in true device pixels, so taps land on the intended element, and it retries the transient idle-state failure by itself.

Workflow knowledge ships as MCP resources the agent can read mid-task, such as the observe-then-act loop, native PIN and lock handling and crash triage; the plugin also installs the guides as skills for clients that ignore resources. The README counts 81 tools and says it is the Android counterpart to XcodeBuildMCP, built on the official Go MCP SDK. The site marks which tools only observe and which can destroy data.

It needs the Android SDK with platform-tools and the emulator, and at least one AVD. If the client starts the server without ANDROID_HOME, pass the SDK path with --sdk. Distribution is a shell installer, a Windows zip, or an OCI image in the MCP registry.

Install

Run in a terminal

claude mcp add adb-mcp -- docker run -i --rm ghcr.io/iksnerd/adb-mcp:0.25.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "adb-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/iksnerd/adb-mcp:0.25.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "adb-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/iksnerd/adb-mcp:0.25.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "adb-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/iksnerd/adb-mcp:0.25.0"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "adb-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/iksnerd/adb-mcp:0.25.0"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "adb-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/iksnerd/adb-mcp:0.25.0"
      ]
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

doctor
Reports what is missing or misconfigured in the setup.
list_avds
Lists available Android virtual devices.
boot_emulator
Boots an AVD.
screenshot
Captures the device screen.
describe_ui
Returns the UI hierarchy with element centres in device pixels.
tap_on_text
Taps an element by its text.

What it does

UI hierarchy reading
describe_ui returns elements with true device-pixel centres for accurate taps.
Emulator control
List AVDs, boot an emulator and take screenshots.
Gradle builds and tests
Run builds and tests, then install and manage apps over adb.
Safety labelling
The site says 18 tools only observe and 22 can destroy data, and each is marked.
Guides as resources
Built-in guides for the driving loop, lock handling and crash triage.
Doctor check
A doctor tool reports what is missing in the setup.

Good for

  • Let an agent boot an emulator and verify a screen after a code change
  • Drive an app through taps and typing to reproduce a bug
  • Run Gradle builds and tests from an agent session
  • Triage a crash from logcat output

Pricing

Open source

Prices change. Check adb-mcp.com before you buy.

adb-mcp: Android emulator and device control over adb FAQ

What do I need installed?

An Android SDK with platform-tools (adb) and the emulator, plus at least one AVD.

What if my client does not set ANDROID_HOME?

Add --sdk with the SDK path to the server args in the client config.

How do I install it?

Run the install.sh script from the repository, use the Windows zip from the releases page, or use the OCI image listed in the registry.

Is it affiliated with Google?

No. The README says it is independent and unofficial.

Is adb-mcp: Android emulator and device control over adb free?

Yes. adb-mcp: Android emulator and device control over adb is open source, so you can use and self-host it for free.

How do I add adb-mcp: Android emulator and device control over adb to Claude Code?

Run this command in your terminal: claude mcp add adb-mcp -- docker run -i --rm ghcr.io/iksnerd/adb-mcp:0.25.0

What are the best alternatives to adb-mcp: Android emulator and device control over adb?

The closest alternatives to adb-mcp: Android emulator and device control over adb are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to adb-mcp: Android emulator and device control over adb

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools