Skip to main content
Glama
Sign In
adb-mcp

adb-mcp

by axe01010
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local
TIP

A single star is the cheapest thank-you — ⭐ the repo if this is useful. It's the only thing that helps other people find it.

🤖 adb-mcp — Let AI agents drive your Android phone

Turn adb into a full Model Context Protocol surface. Tap, swipe, screencap, install, read packages, watch logcat — directly from Claude, Cursor, or any MCP-capable agent. Your phone becomes an AI-controlled device.

Why

  • "AI controls your phone" is the 2026 demo — and adb is the closest thing to a universal phone API.

  • One command to mount your device as a set of tools any agent can call.

  • Works over WiFi (adb pair/connect) or USB on Linux, macOS, Windows, and Termux on Android.

  • Zero cloud — everything stays on your local machine. Private by design.

Related MCP server: scrcpy-mcp

Install

pipx install adb-mcp        # or: pip install adb-mcp
adb-mcp                     # stdio transport, targets default device

Or run with an explicit device:

adb-mcp --device <serial>

Plug into Claude Desktop

Add this to claude_desktop_config.json:

{ "mcpServers": { "adb": { "command": "adb-mcp" } } }

Plug into Cursor

Add a new MCP server entry with command adb-mcp and type stdio.

Quick start (no device needed)

Try it against the built-in mock adb, fully offline:

adb-mcp --mock
python -m pytest tests/ -q        # 5 passing tests, zero hardware needed

Included tools

Category

Tools

Devices

list_devices

Screen

screencap, tap, swipe

Input

input_text, keyevent

Apps

list_packages, install_apk, launch

Diagnostics

battery, logcat

Each tool runs a scoped, time-limited adb shell/adb exec-out call — no root, no persistent anything.

Project layout

adb-mcp/
├─ pyproject.toml        # hatchling build, `adb-mcp` console script
├─ adb_mcp/
│  ├─ server.py          # FastMCP server + all tool registrations
│  ├─ adb.py             # Adb / MockAdb transport
│  └─ __init__.py
├─ tests/test_tools.py    # mock-based, device-free tests
└─ README.md

Where to go next (roadmap)

  • over-screenrecord GIF framing for the README demo

  • files/ module: scoped push/pull

  • CE/ streaming logcat

  • pairing wizard for wireless adb pair

  • topic badges + GH Actions test on push

Architecture

flowchart LR
    Agent[Any AI Agent] <--> MCP[MCP stdio]
    MCP --> adbc{adb-mcp server}
    adbc --> Shell[adb shell]
    Shell --> Phone((Android Phone))
    Phone --> T[tap / swipe / screencap]
    Phone --> A[install / launch]
    Phone --> L[logcat]
    Phone --> P[packages]

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Android ADB MCP Server

      xuegao-tzx
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables programmatic control of Android devices via ADB, supporting UI automation, app management, screen capture with OCR, and file transfers through the Model Context Protocol. It allows MCP-compatible clients like Claude Desktop and Cursor to interact directly with physical or emulated Android devices.
      19 PyPI
      3
      Apache 2.0

    • scrcpy-mcp

      JuanCF
      A
      license
      A
      quality
      C
      maintenance
      MCP server that gives AI agents full vision and control over Android devices via ADB and scrcpy. Supports screenshots, input, apps, UI automation, shell, files, and clipboard.
      38
      374 npm
      131
      MIT

    • adb-mcp-server

      sfaizi24
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables MCP-compatible agents to control an Android device over the network via ADB, providing tools for shell commands, screen capture, UI inspection, file operations, and input simulation.
      16 npm
      MIT