Skip to main content
Glama

ADB MCP Server

npm version License: MIT

Inspect, manage, debug, and run commands on connected Android devices and emulators — through natural language.

Demo

Related MCP server: Enhanced ADB MCP Server

Supported Features

📱 Devices & Networking

Manage connection, state, and port-forwarding rules of connected devices.

Discovery — List connected devices and emulators with models, products, and connection details.

Wi-Fi Connections — Connect and disconnect devices over TCP/IP (Wi-Fi).

State & Reboot — Check online/offline states and reboot into recovery or bootloader modes.

Privilege Control — Restart the ADB daemon with or without root privileges (adb root).

Port Forwarding — Forward local host ports to the device (forward_port) or reverse ports from the device to the host (reverse_port), critical for bundlers like React Native Metro.


📦 Apps

Install, run, and manage application packages.

Install / Uninstall — Install APKs from the host (supporting reinstall and downgrade flags) and uninstall packages.

List & Filter — List installed packages on the device, filtered by system, third-party, enabled, or disabled categories.

Application Control — Launch apps (either directly using a main activity path or triggering launcher intents) and force-stop packages.

Permissions — Grant or revoke runtime permissions dynamically on the fly.


📂 File Transfer

Move files to and from the Android filesystem.

Push — Copy local host files or folders onto the device.

Pull — Retrieve files or folders from the device filesystem back to the host.


📋 Logs & Diagnostics

Access debugging logs and capture device media.

Logcat Logs — Dump snapshots of recent system logs with custom limits and logcat tag/level filter criteria.

Clear Logs — Flush logcat buffers before running tests.

Screenshots — Capture device screen and return it directly as a renderable PNG image to the MCP client, or save it to a host path.

Screen Recording — Record screen videos as MP4 files (1 to 180 seconds) and pull them directly to the host machine.

Diagnostics — Run dumpsys diagnostics for any service (battery, cpuinfo, window) and read system properties (getprop).

UI Hierarchy — Dump screen layout tree XMLs (dump_ui_hierarchy) using uiautomator to allow the AI to inspect and locate on-screen components.

Performance — Read app memory RAM statistics (get_app_memory) and live device CPU load stats (get_cpu_usage).


🖱️ User Input Simulation

Automate actions and simulate user interactions on the screen.

Taps & Swipes — Tap coordinates (tap_screen) and perform swipes or drag-gestures (swipe_screen).

Hardware Buttons — Simulate hardware key presses (BACK, HOME, POWER, MENU, VOLUME) using send_keyevent.

Text Input — Type strings directly into focused input fields (type_text) with automatic space-escaping.


🗄️ Database & Storage Tools

Inspect SQLite database states and app configurations.

Database Diagnostics — Dump database statistics, open connections, query caches, and memory details using dumpsys dbinfo.

SQLite Queries — Run SQL commands (e.g. SELECT, .tables, .schema) directly on an app's sandboxed databases using run-as (requires a debuggable app or rooted environment, runs safely without host command injection).

Shared Preferences — List preferences files (list_shared_preferences) and read preference XML contents (get_shared_preferences) inside sandboxed apps.


⚙️ Raw Execution

Run low-level commands that are not exposed as high-level tools.

Raw ADB — Execute arbitrary ADB arguments as safe process argument arrays.

Device Shell — Run arbitrary shell commands directly inside the device.


Quick Start

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": ["-y", "adb-mcp-server"]
    }
  }
}

Ensure adb is installed on your machine and available in your shell PATH.


Setup Instructions

Claude Desktop

Config file path:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": ["-y", "adb-mcp-server"]
    }
  }
}

Antigravity (Google AI IDE)

Config file path:

  • macOS/Linux: ~/.gemini/config/mcp_config.json

Add the server to your mcp_config.json under the mcpServers block:

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": ["-y", "adb-mcp-server"]
    }
  }
}

Alternatively, configure via the UI:

  1. Open the Agent Panel in the top right.

  2. Select Manage MCP Servers or go to Settings → Customizations.

  3. Add a custom MCP server:

    • Command: npx

    • Arguments: -y adb-mcp-server

Cursor

  1. Open Settings → Features → MCP

  2. Click + Add New MCP Server

  3. Set:

    • Name: adb

    • Type: command

    • Command: npx -y adb-mcp-server

Windsurf

Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": ["-y", "adb-mcp-server"]
    }
  }
}

VS Code (Cline / Roo Code)

Config file path:

  • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "adb": {
      "command": "npx",
      "args": ["-y", "adb-mcp-server"]
    }
  }
}

Claude Code (CLI)

claude mcp add npx -- -y adb-mcp-server

Example Prompts

List all connected Android devices. What are their model names?
Take a screenshot of my connected emulator and show it to me.
Install the app APK located at /Users/user/Downloads/app.apk and start its main activity.
Get the last 100 logcat lines from my device. Filter logs by "MyReactAppName" tag.
Run "SELECT * FROM settings WHERE value = 'dark';" on the database "app_prefs.db" inside the package "com.example.myapp".
Read the shared preferences file "user_settings" for package "com.example.myapp".
Press the power button on the device using keyevent.
Reverse port 8081 for React Native Metro bundler.
Dump the layout UI hierarchy XML of the current screen to inspect the visible components.
Tap the screen at coordinates (300, 750) and then type the text "hello world" into the input.

License

MIT

Available Tools

42 tools
clear_app_dataA

Delete all data associated with a package (resets app to clean state, clears cache).

Inputs: packageName (required), serial.

clear_logcatA

Clear (flush) all current logcat buffers. Useful to run before a test to discard old irrelevant logs.

Inputs: serial.

connect_deviceA

Connect to an Android device over TCP/IP (Wi-Fi) using its IP address and optional port.

Inputs: host (required), port.

disconnect_deviceA

Disconnect from a previously connected TCP/IP (Wi-Fi) device.

Inputs: host (required), port.

dump_ui_hierarchyA

Dump the current layout tree (UI hierarchy XML) of the screen using uiautomator. Highly useful for AI agents to inspect what UI elements are currently visible.

Inputs: serial.

execute_raw_adbB

Execute an arbitrary ADB command by passing raw command-line arguments. Safe from shell injection on the host machine because arguments are passed as an array.

Inputs: args (required), serial.

execute_shell_commandB

Execute an arbitrary shell command directly on the connected Android device. Allows full access to Android shell utilities (e.g., 'input keyevent 26', 'settings get global airplane_mode_on').

Inputs: command (required), serial.

force_stop_appB

Force stop all processes associated with the application package.

Inputs: packageName (required), serial.

forward_portB

Forward socket connections from a local host port to a port on the connected device.

Inputs: local (required), remote (required), serial, noRebind.

get_app_memoryB

Dump detailed RAM memory statistics (meminfo) for an app package name.

Inputs: packageName (required), serial.

get_app_usageC

Retrieve app usage and screen time statistics from the device using the usagestats or batterystats services.

Inputs: serial, service, packageName.

get_cpu_usageA

Retrieve current CPU load statistics from the device shell using dumpsys cpuinfo.

Inputs: serial.

get_dbinfoA

Retrieve SQLite database statistics and diagnostics for running apps using dumpsys dbinfo. Optionally filter by application package.

Inputs: serial, verbose, packageName.

get_device_stateB

Get the current state of a connected device (e.g. offline, bootloader, device).

Inputs: serial.

get_dumpsysB

Retrieve system diagnostic details (dumpsys) for a service or package.

Inputs: serial, packageName, serviceName.

get_logcatA

Dump a snapshot of recent system logs (logcat) with custom line limits and filter criteria.

Inputs: limit, serial, filterSpec.

get_propertiesA

Retrieve system property values (getprop) from the Android device.

Inputs: serial, propertyName.

get_shared_preferencesA

Retrieve and read the XML contents of a specific Shared Preferences file inside an app's sandbox. Requires a debuggable app or root.

Inputs: filename (required), packageName (required), serial.

grant_permissionB

Grant a runtime permission to an application package on the device.

Inputs: permission (required), packageName (required), serial.

install_appB

Install an APK from the host machine onto the connected device.

Inputs: apkPath (required), serial, reinstall, allowDowngrade.

list_devicesA

List all connected Android devices and emulators, including their serial numbers, connection status, and details (product, model, device, transport).

Inputs: no named parameters.

list_forwardsA

List all active port forwarding connections from host to device.

Inputs: serial.

list_packagesA

List all installed application packages on the device, with options to filter by name or package type.

Inputs: type, filter, serial.

list_reversesA

List all active reverse port connections from device to host.

Inputs: serial.

list_shared_preferencesA

List all Shared SharedPreferences (preferences XML files) inside an application sandbox. Requires a debuggable app or root.

Inputs: packageName (required), serial.

pull_fileA

Copy a file or directory from the connected device to the host machine.

Inputs: localPath (required), remotePath (required), serial.

push_fileA

Copy a file or directory from the host machine to the connected device.

Inputs: localPath (required), remotePath (required), serial.

query_sqliteA

Execute a SQL query/command on a SQLite database within an app's sandboxed data directory. Note: Only works on debuggable apps or rooted devices/emulators.

Inputs: query (required), dbName (required), packageName (required), serial.

reboot_deviceA

Reboot the connected device into different modes: system, bootloader, recovery, or sideload.

Inputs: mode, serial.

record_screenA

Record the device screen as an MP4 video for a given duration and save it to the host computer.

Inputs: savePath (required), serial, duration.

reverse_portA

Reverse socket connections from a port on the device to a port on the local host (critical for React Native bundler reverse tcp:8081).

Inputs: local (required), remote (required), serial, noRebind.

revoke_permissionA

Revoke a runtime permission from an application package on the device.

Inputs: permission (required), packageName (required), serial.

root_deviceA

Restart the adbd daemon on the device with root permissions. Note: Only works on userdebug/eng builds or rooted devices.

Inputs: serial.

send_keyeventA

Send a keyevent (hardware/system key simulation) to the device (e.g. BACK=4, HOME=3, POWER=26, APP_SWITCH=187).

Inputs: keycode (required), serial.

set_mock_locationA

Set a mock GPS location (latitude and longitude) on the device. For emulators, this works directly. For physical devices, you must configure a Mock Location App in Developer Options first.

Inputs: latitude (required), longitude (required), serial.

start_app_activityA

Launch an app or a specific activity on the device. If activity is not provided, launches the default launcher activity.

Inputs: packageName (required), serial, activityName.

swipe_screenA

Swipe from starting coordinates to ending coordinates, with an optional duration parameter to simulate drag actions.

Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +2 more.

take_screenshotA

Capture the device screen. If savePath is provided, saves to the host machine. Otherwise, returns the image directly to the client as a renderable PNG image.

Inputs: serial, savePath.

tap_screenB

Tap the screen at specific X and Y coordinates.

Inputs: x (required), y (required), serial.

type_textA

Type text into the currently focused input field. Automatically formats space characters for compatibility with the adb shell.

Inputs: text (required), serial.

uninstall_appB

Uninstall an application package from the connected device.

Inputs: packageName (required), serial, keepData.

unroot_deviceA

Restart the adbd daemon on the device without root permissions (restores non-root privileges).

Inputs: serial.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 42 tools

    Disambiguation4/5

    Most tools have distinct purposes, but `execute_raw_adb` and `execute_shell_command` both execute arbitrary commands (on host vs device) and could be confused. Also `get_shared_preferences` and `list_shared_preferences` are similar but clearly one lists and one reads. Overall, the tool set is well-differentiated.

    Naming Consistency5/5

    Every tool uses a verb_noun pattern, e.g., `reboot_device`, `install_app`, `pull_file`, `take_screenshot`. Even multi-word tools like `force_stop_app` and `dump_ui_hierarchy` maintain verb-first naming. No mixed conventions or camelCase.

    Tool Count2/5

    With 42 tools, the server far exceeds the 25-tool threshold, making it heavy. While ADB is a broad domain, many tools are narrow (e.g., `get_dbinfo`, `list_shared_preferences`, `get_shared_preferences`) and could be consolidated. The count feels excessive for a typical MCP server.

    Completeness4/5

    The tool surface covers device management, app lifecycle, file transfer, UI interaction, system diagnostics, and arbitrary execution. Minor gaps include backup/restore and some advanced device features, but the presence of `execute_shell_command` mitigates most missing functionality.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables comprehensive control of Android devices via ADB for Flutter development, UI testing, and visual QA workflows. Provides 60+ tools for device management, UI inspection, app testing, performance profiling, and debugging through natural language.
      77
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Android devices and emulators through ADB, allowing control actions like tapping, text input, screenshots, UI inspection, and app launching through natural language.
      13 npm
      8
      ISC
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to interact with Android devices and emulators via ADB, providing tools for screenshots, UI inspection, touch and text input, app management, and device control.
      42
      200 npm
      22
      MIT