whatisgithub

What is adb-mcp?

mrnewdelhi/adb-mcp — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

adb-mcp lets AI agents control Android phones and emulators by exposing ADB's commands as structured tools instead of raw command-line syntax.

Mindmap

mindmap
  root((adb-mcp))
    What it does
      Wraps ADB commands
      Serves MCP tools
      Controls Android devices
    Tech stack
      TypeScript
      Node.js
      Android Platform Tools
    Use cases
      Agent-driven testing
      Screenshot automation
      App install and logs
    Audience
      Developers
      AI agent builders
    Setup
      Needs adb on path
      Test devices only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI agent take screenshots and tap through an Android app automatically.

USE CASE 2

Automate installing apps and capturing logs from a test device or emulator.

USE CASE 3

Give an agent a raw ADB command escape hatch for anything the built-in tools miss.

What is it built with?

TypeScriptNode.jsMCPADB

How does it compare?

mrnewdelhi/adb-mcp0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 20+ and Android Platform Tools with adb already on the system path.

License terms are not stated in the provided text.

So what is it?

adb-mcp is a server that connects AI agents to Android devices and emulators through a protocol called MCP (Model Context Protocol). Android Debug Bridge, or ADB, is the standard command-line toolkit for communicating with Android phones, tablets, and virtual devices, adb-mcp wraps nearly all of ADB's capabilities into structured tools that agents can call directly. The problem it solves: automating an Android device normally requires knowing specific ADB command syntax. adb-mcp removes that requirement by exposing every common ADB operation as a named, typed function. An agent can take a screenshot, install an app, tap the screen, capture logs, reboot the device, inspect installed packages, or run shell commands, all without constructing raw ADB strings. For anything the built-in tools don't cover, a raw adb_command escape hatch is available. The tool groups cover a wide surface: device discovery and connection, shell execution and system properties, app install and package management, file transfer, screen capture and recording, logcat and bug reports, input simulation, network and port management, and emulator console control. To run it you need Node.js 20 or newer and Android Platform Tools already installed, with the adb binary on your system path. You build the server from TypeScript source, then register it in your MCP client's configuration. From that point, any MCP-compatible AI agent can control connected Android devices as part of its workflow. It is written in TypeScript and is intended for use with test devices or emulators rather than production hardware, since many operations can change device state or erase data.

Copy-paste prompts

Prompt 1
Show me how to register adb-mcp in my MCP client's configuration after building it from source.
Prompt 2
Explain which ADB operations adb-mcp exposes as named tools versus the raw adb_command escape hatch.
Prompt 3
Help me use adb-mcp to automate installing an app and taking a screenshot on an emulator.
Prompt 4
Walk me through setting up Android Platform Tools so the adb binary is on my system path.

Frequently asked questions

What is adb-mcp?

adb-mcp lets AI agents control Android phones and emulators by exposing ADB's commands as structured tools instead of raw command-line syntax.

What language is adb-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

What license does adb-mcp use?

License terms are not stated in the provided text.

How hard is adb-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is adb-mcp for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.