Android Debug Bridge MCP

Android Debug Bridge MCP

tiagodanin

Controls Android devices through ADB for automation and testing. Lets you interact with apps, capture screenshots, analyze UI elements, and simulate user input via natural language commands.

Enables control of Android devices via ADB for automation and testing. Supports app management, screen capture, UI analysis, and input simulation through natural language commands.

18181 views6Local (stdio)

What it does

  • Launch and manage Android apps
  • Capture screenshots and UI hierarchy dumps
  • Simulate touch gestures and keyboard input
  • Send system key events (back, home, enter)
  • List installed applications by name pattern
  • Create organized test folders for automation

Best for

Mobile app developers testing applicationsQA engineers automating Android testingBuilding AI agents that interact with mobile apps
Works with physical devices and emulatorsNatural language command interface

About Android Debug Bridge MCP

Android Debug Bridge MCP is a community-built MCP server published by tiagodanin that provides AI assistants with tools and capabilities via the Model Context Protocol. Control Android devices via Android Debug Bridge (ADB): automate testing, manage apps, capture screens, analyze UI, and It is categorized under developer tools. This server exposes 9 tools that AI clients can invoke during conversations and coding sessions.

How to install

You can install Android Debug Bridge MCP in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

License

Android Debug Bridge MCP is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

Tools (9)

create_test_folder

Create a test folder with the specified name

list_apps

List installed apps matching a name pattern

open_app

Open an app using its package name and activity

capture_screenshot

Capture a screenshot and save it to the test folder

capture_ui_dump

Capture UI hierarchy dump from the device

Android Debug Bridge MCP

MCP plugin to control Android devices via ADB for automation, testing, and agent integration.

Features

This MCP server provides tools to:

  • Test Management: Create test folders for organizing automation tests
  • App Control: List installed apps by name pattern and open apps by package name
  • Screen Capture: Take screenshots and save them to organized test folders
  • UI Analysis: Capture UI hierarchy dumps for element inspection
  • Input Simulation:
    • Send key events (BACK, HOME, ENTER, DELETE)
    • Tap at specific coordinates
    • Input text into active fields
    • Scroll in any direction (up, down, left, right)

Installation

Install the package globally via npm:

npm install -g android-debug-bridge-mcp

Setup for Different AI Clients

Claude Code (CLI)

Add to your MCP configuration in ~/.claude/mcp.json:

{
  "mcpServers": {
    "android-debug-bridge": {
      "command": "npx",
      "args": ["android-debug-bridge-mcp"]
    }
  }
}

or

claude mcp add --scope project android-debug-bridge-mcp -- npx android-debug-bridge-mcp

Cursor

Add to your MCP configuration in Cursor settings:

  1. Open Cursor Settings
  2. Navigate to Extensions → MCP
  3. Add a new server with:
    • Name: android-debug-bridge
    • Command: npx
    • Args: ["android-debug-bridge-mcp"]

Claude Desktop

Add to your MCP configuration file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "android-debug-bridge": {
      "command": "npx",
      "args": ["android-debug-bridge-mcp"]
    }
  }
}

Prerequisites

  • Android Debug Bridge (ADB) must be installed and available in your PATH
  • Android device with USB debugging enabled, or Android emulator running
  • Device must be connected and authorized for debugging

Usage

Once configured, you can interact with Android devices through your AI client by asking questions like:

  • "Create a test folder called 'login_test'"
  • "List all apps with 'chrome' in the name"
  • "Open the app com.android.chrome"
  • "Take a screenshot and save it as step '001_homepage'"
  • "Capture the current UI hierarchy in my app"
  • ...

License

MIT

Alternatives

Related Skills

Browse all skills
godot

This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.

732
reverse-engineering-tools

Guide for reverse engineering tools and techniques used in game security research. Use this skill when working with debuggers, disassemblers, memory analysis tools, binary analysis, or decompilers for game security research.

47
python-expert

Senior Python developer expertise for writing clean, efficient, and well-documented code. Use when: writing Python code, optimizing Python scripts, reviewing Python code for best practices, debugging Python issues, implementing type hints, or when user mentions Python, PEP 8, or needs help with Python data structures and algorithms.

40
chrome-devtools

Browser automation, debugging, and performance analysis using Puppeteer CLI scripts. Use for automating browsers, taking screenshots, analyzing performance, monitoring network traffic, web scraping, form automation, and JavaScript debugging.

30
penpot-uiux-design

Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: "design a UI", "create interface", "build layout", "design dashboard", "create form", "design landing page", "make it accessible", "design system", "component library".

19
ui-design-system

UI design system toolkit for Senior UI Designer including design token generation, component documentation, responsive design calculations, and developer handoff tools. Use for creating design systems, maintaining visual consistency, and facilitating design-dev collaboration.

18