adb-mcp: Android emulator and device control over adb
Lets an agent drive Android emulators and devices over adb: inspect UI, tap, build, test
- 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.0Add to claude_desktop_config.json
{
"mcpServers": {
"adb-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/iksnerd/adb-mcp:0.25.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"adb-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/iksnerd/adb-mcp:0.25.0"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools