# 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. Lets an agent drive Android emulators and devices over adb: inspect UI, tap, build, test. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Website:** https://adb-mcp.com
- **Repository:** https://github.com/iksnerd/adb-mcp
- **MCP Registry name:** io.github.iksnerd/adb-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/adb-mcp-android-emulator-and-device-control-over-adb
