Skip to main content
Glama
Enhanced ADB MCP Server
by rahulkr

Enhanced ADB MCP Server for Flutter/Android Development

PyPI version Python 3.10+ License: MIT

A comprehensive MCP server for controlling Android devices via ADB, specifically designed for Flutter development, UI testing, and visual QA workflows.

Quick Start

# Install from PyPI
pip install r-adb-mcp-server

# Or run directly with uvx (no installation needed)
uvx r-adb-mcp-server

Note: Both the package name and command are r-adb-mcp-server.

Then add to your MCP client configuration (Claude Desktop, Cursor, etc.) - see Configuration section below.

Related MCP server: Android MCP

Features

πŸ“± Device Management

  • List connected devices with details

  • Get comprehensive device info (model, Android version, battery, etc.)

  • Screen specifications with DP calculations

πŸ“Έ Visual Capture

  • Screenshots (base64 or file)

  • Screen recording with start/stop control

  • Capture with metadata for Figma comparison

πŸ” UI Inspection

  • Full UI hierarchy dump (XML)

  • Find elements by text or resource ID

  • Get all clickable elements with coordinates

  • Extract all visible text for verification

🎯 Input & Interaction

  • Tap, double-tap, long-press

  • Swipe and scroll (up/down/to-text)

  • Text input and clear

  • Key events (HOME, BACK, ENTER, etc.)

  • Tap elements by text or ID

πŸ“¦ App Management

  • Launch/stop/clear apps

  • Install/uninstall APKs

  • List packages with filtering

  • Get current activity

  • App info (version, install date, etc.)

πŸ› Debugging & Logs

  • Logcat with filtering (tag, level, package)

  • Flutter-specific logs

  • Crash logs extraction

  • ANR traces

⚑ Performance Profiling

  • Memory usage per app

  • CPU monitoring

  • GPU rendering info

  • Frame stats for jank detection

  • Battery statistics

🌐 Network Control

  • Network info (WiFi status, IP)

  • Toggle WiFi/Airplane mode

  • Set/clear HTTP proxy

βš™οΈ Developer Options

  • Animation scale (speed up tests)

  • Show taps (for recordings)

  • Show layout bounds

  • Screen rotation control

  • Change resolution/density

β™Ώ Accessibility Testing

  • Font scale adjustment

  • TalkBack toggle

  • High contrast mode

  • Color inversion

πŸ“ Emulator Features

  • GPS location spoofing

  • Simulate SMS/calls

Prerequisites

  1. ADB installed and in your PATH

    adb version
  2. Android device/emulator connected with USB debugging enabled

    adb devices
  3. Python 3.10+ and optionally uv for running with uvx

    To install uv (optional, for uvx command):

    # macOS/Linux
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
    # Or with Homebrew (macOS)
    brew install uv
    
    # Or with pip
    pip install uv

Installation

# Install globally with pip
pip install r-adb-mcp-server

# Or use with uvx (no installation needed)
uvx r-adb-mcp-server

From Source

cd adb-mcp-server

# Using uv (recommended)
uv sync

# Or using pip
pip install -e .

Configuration

Claude Desktop

Using installed package (recommended):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "adb": {
      "command": "uvx",
      "args": ["r-adb-mcp-server"]
    }
  }
}

Or if installed with pip:

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

Using from source:

{
  "mcpServers": {
    "adb": {
      "command": "uv",
      "args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
    }
  }
}

Cursor IDE

Add to .cursor/mcp.json:

Using installed package (recommended):

{
  "mcpServers": {
    "adb": {
      "command": "uvx",
      "args": ["r-adb-mcp-server"]
    }
  }
}

Using from source:

{
  "mcpServers": {
    "adb": {
      "command": "uv",
      "args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
    }
  }
}

Claude Code

Using installed package (recommended):

claude mcp add adb -- uvx r-adb-mcp-server

Using from source:

claude mcp add adb -- uv --directory /path/to/adb-mcp-server run python src/adb_mcp_server/server.py

GitHub Copilot

Using installed package (recommended):

Add to your VS Code settings (.vscode/settings.json or User Settings):

{
  "github.copilot.chat.mcp.servers": {
    "adb": {
      "command": "uvx",
      "args": ["r-adb-mcp-server"]
    }
  }
}

Or if installed with pip:

{
  "github.copilot.chat.mcp.servers": {
    "adb": {
      "command": "r-adb-mcp-server"
    }
  }
}

Using from source:

{
  "github.copilot.chat.mcp.servers": {
    "adb": {
      "command": "uv",
      "args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
    }
  }
}

Note: Make sure you have GitHub Copilot Chat extension installed and MCP support enabled in VS Code.

Available Tools (60+)

Device Management

Tool

Description

list_devices()

List all connected devices

get_device_info()

Comprehensive device details

get_screen_specs()

Screen size, density, DP values

Visual Capture

Tool

Description

screenshot()

Capture as base64 PNG

screenshot_to_file(filename)

Save screenshot to file

start_screen_record(duration, filename)

Start recording (max 180s)

stop_screen_record()

Stop recording

pull_recordings(local_dir)

Download recordings

capture_screen_for_comparison(name)

Screenshot with metadata

UI Inspection

Tool

Description

get_ui_hierarchy()

Full UI tree as XML

get_clickable_elements()

All tappable elements with coordinates

find_element_by_text(text)

Find by text content

find_element_by_id(resource_id)

Find by resource ID

get_all_text_on_screen()

Extract all visible text

Input & Interaction

Tool

Description

tap(x, y)

Tap at coordinates

tap_element(text, resource_id)

Tap by element identifier

double_tap(x, y)

Double tap

long_press(x, y, duration)

Long press

swipe(x1, y1, x2, y2, duration)

Swipe gesture

scroll_down() / scroll_up()

Scroll screen

scroll_to_text(text)

Scroll until text visible

input_text(text)

Type text

clear_text_field(length)

Clear current field

press_key(keycode)

Press any key

press_back() / press_home()

Navigation buttons

App Management

Tool

Description

get_current_activity()

Current foreground app

launch_app(package)

Launch by package name

launch_activity(package, activity)

Launch specific activity

force_stop_app(package)

Force stop app

clear_app_data(package)

Clear app data

list_packages(filter, include_system)

List installed apps

get_app_info(package)

App details

install_apk(path)

Install APK

uninstall_app(package)

Uninstall app

Debugging & Logs

Tool

Description

get_logcat(lines, filter_tag, level)

Get logs

clear_logcat()

Clear log buffer

get_flutter_logs(lines)

Flutter-specific logs

get_crash_logs(package)

Crash/exception logs

get_anr_traces()

ANR traces

Performance

Tool

Description

get_memory_info(package)

Memory usage

get_cpu_info()

CPU usage

get_battery_stats()

Battery details

get_gpu_info()

GPU rendering info

get_frame_stats(package)

Frame timing stats

Network

Tool

Description

get_network_info()

WiFi status, IP

toggle_wifi(enable)

Enable/disable WiFi

toggle_airplane_mode(enable)

Toggle airplane mode

set_proxy(host, port)

Set HTTP proxy

clear_proxy()

Clear proxy

Developer Options

Tool

Description

toggle_show_taps(enable)

Visual tap feedback

toggle_show_layout_bounds(enable)

Show layout bounds

set_animation_scale(scale)

Animation speed (0-1)

rotate_screen(orientation)

portrait/landscape/auto

change_screen_size(w, h)

Override resolution

reset_screen_size()

Reset to default

change_density(dpi)

Override DPI

reset_density()

Reset to default

Accessibility

Tool

Description

set_font_scale(scale)

System font size

toggle_talkback(enable)

Screen reader

toggle_high_contrast(enable)

High contrast text

toggle_color_inversion(enable)

Invert colors

Files & Shell

Tool

Description

push_file(local, remote)

Copy to device

pull_file(remote, local)

Copy from device

list_files(path)

List directory

read_file(path)

Read text file

shell_command(cmd)

Run any shell command

reboot_device(mode)

Reboot device

Emulator Only

Tool

Description

set_location(lat, lng)

Fake GPS location

send_sms(number, message)

Simulate SMS

simulate_call(number)

Simulate incoming call

Example Prompts

Basic Usage

  • "Take a screenshot of my phone"

  • "What's the current screen resolution and density?"

  • "List all installed apps containing 'flutter'"

  • "What's currently on screen? Get all the text"

UI Testing

  • "Find the login button and tap it"

  • "Scroll down until you find 'Settings'"

  • "Get all clickable elements and their positions"

  • "Type 'test@email.com' into the current field"

Debugging

  • "Show me the last 50 Flutter logs"

  • "Are there any crash logs for my app?"

  • "What's the memory usage of com.myapp?"

Visual QA

  • "Capture this screen for comparison with Figma"

  • "Take a screenshot and tell me about the UI structure"

  • "Set the font scale to 1.3 and take a screenshot for accessibility testing"

Performance Testing

  • "Set animation scale to 0 and run through the app"

  • "Get frame stats for my app - is there any jank?"

  • "What's the GPU rendering performance?"

Device Simulation

  • "Change the screen to 1080x1920 to simulate a smaller phone"

  • "Rotate to landscape mode"

  • "Set location to San Francisco (37.7749, -122.4194)"

Extending

Add new tools easily:

@mcp.tool()
def my_custom_tool(param: str, device_serial: str | None = None) -> str:
    """Description shown to AI"""
    return run_adb(["shell", "your-command", param], device_serial)

Tips for Flutter Development

  1. Speed up tests: Use set_animation_scale(0) to disable animations

  2. Visual QA: Use capture_screen_for_comparison() with Figma MCP

  3. Debug logs: get_flutter_logs() filters Flutter-specific output

  4. Hot reload: Keep flutter run terminal open, use device for interaction

  5. Responsive testing: Use change_screen_size() and change_density()

License

MIT

Available Tools

77 tools
capture_screen_for_comparisonC

Capture screenshot with metadata for visual comparison. Saves PNG and returns info for comparing with Figma designs.

Inputs: screen_name (required), output_dir, device_serial.

change_densityC

Change screen density - useful for testing different DPI

Inputs: dpi (required), device_serial. Returns: result

change_screen_sizeB

Change screen resolution - useful for testing different screen sizes

Inputs: width (required), height (required), device_serial. Returns: result

check_flutter_app_runningC

Check if a Flutter app is currently in foreground

Inputs: device_serial.

clear_app_dataC

Clear all data for an app (like fresh install)

Inputs: package_name (required), device_serial. Returns: result

clear_logcatB

Clear the logcat buffer

Inputs: device_serial. Returns: result

clear_proxyB

Clear HTTP proxy settings

Inputs: device_serial. Returns: result

clear_text_fieldC

Clear text in current field by sending delete keys

Inputs: length, device_serial. Returns: result

double_tapC

Double tap at coordinates

Inputs: x (required), y (required), device_serial. Returns: result

find_element_by_idB

Find a UI element by its resource ID. Returns element details including tap coordinates.

Inputs: resource_id (required), device_serial. Returns: result

find_element_by_textB

Find UI elements containing specific text. Returns element details including tap coordinates.

Inputs: text (required), partial_match, device_serial. Returns: result

force_stop_appC

Force stop an app

Inputs: package_name (required), device_serial. Returns: result

get_accessibility_infoB

Get accessibility service information - useful for a11y testing

Inputs: device_serial. Returns: result

get_all_text_on_screenB

Extract all visible text from current screen. Useful for verifying text content matches designs.

Inputs: device_serial. Returns: result

get_anr_tracesC

Get ANR (Application Not Responding) traces

Inputs: device_serial. Returns: result

get_app_infoC

Get detailed information about an installed app

Inputs: package_name (required), device_serial.

get_battery_statsC

Get detailed battery statistics

Inputs: device_serial.

get_clickable_elementsB

Get all clickable/interactive elements on screen with their coordinates. Perfect for understanding what can be tapped.

Inputs: device_serial. Returns: result

get_cpu_infoC

Get CPU usage information

Inputs: device_serial. Returns: result

get_crash_logsC

Get crash/exception logs

Inputs: package_name, device_serial. Returns: result

get_current_activityB

Get the currently focused app and activity

Inputs: device_serial.

get_device_infoC

Get comprehensive device information

Inputs: device_serial.

get_element_colors_at_positionC
Note: This captures a screenshot and the caller can analyze the pixel.
For actual color extraction, use image processing on the screenshot.

Inputs: x (required), y (required), device_serial. Returns: result

get_flutter_logsD

Get Flutter-specific logs

Inputs: lines, device_serial. Returns: result

get_flutter_performance_overlayC

Get Flutter rendering performance info

Inputs: package_name (required), device_serial. Returns: result

get_frame_statsC

Get frame rendering stats for an app - useful for detecting jank

Inputs: package_name (required), device_serial. Returns: result

get_gpu_infoB

Get GPU rendering information - useful for performance debugging

Inputs: device_serial. Returns: result

get_logcatC
Get logcat output.

filter_level: V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal)

Inputs: lines, filter_tag, filter_level, package_name, +1 more. Returns: result

get_memory_infoC

Get memory usage information

Inputs: package_name, device_serial. Returns: result

get_network_infoC

Get network connectivity information

Inputs: device_serial.

get_screen_specsC

Get detailed screen specifications - useful for responsive design

Inputs: device_serial.

get_ui_hierarchyB

Dump the complete UI hierarchy as XML. Shows all visible elements, their properties, bounds, and content descriptions.

Inputs: device_serial. Returns: result

input_textA

Type text into the currently focused field

Inputs: text (required), device_serial. Returns: result

install_apkC

Install an APK file

Inputs: apk_path (required), device_serial. Returns: result

launch_activityD

Launch a specific activity

Inputs: package_name (required), activity_name (required), device_serial. Returns: result

launch_appC

Launch an app by package name

Inputs: package_name (required), device_serial. Returns: result

list_devicesB

List all connected Android devices with details

Inputs: no named parameters. Returns: result

list_filesB

List files in a directory on the device

Inputs: remote_path, device_serial. Returns: result

list_packagesB

List installed packages, optionally filtered

Inputs: filter_text, include_system, device_serial. Returns: result

long_pressC

Long press at coordinates for specified duration

Inputs: x (required), y (required), duration_ms, device_serial. Returns: result

press_backC

Press the back button

Inputs: device_serial. Returns: result

press_homeB

Press the home button

Inputs: device_serial. Returns: result

press_keyB
Press a key by keycode name or number.

Common keycodes:
- HOME (3), BACK (4), CALL (5), ENDCALL (6)
- VOLUME_UP (24), VOLUME_DOWN (25), POWER (26)
- CAMERA (27), ENTER (66), DEL/BACKSPACE (67)
- TAB (61), SPACE (62), MENU (82)
- SEARCH (84), MEDIA_PLAY_PAUSE (85)
- PAGE_UP (92), PAGE_DOWN (93)

Inputs: keycode (required), device_serial. Returns: result

press_recent_appsB

Open recent apps / app switcher

Inputs: device_serial. Returns: result

pull_fileC

Pull a file from the device

Inputs: remote_path (required), local_path (required), device_serial. Returns: result

pull_recordingsB

Pull all screen recordings from device to local directory

Inputs: local_dir, device_serial. Returns: result

push_fileC

Push a file to the device

Inputs: local_path (required), remote_path (required), device_serial. Returns: result

read_fileC

Read a text file from the device

Inputs: remote_path (required), device_serial. Returns: result

reboot_deviceC
Reboot the device.
mode: 'normal', 'bootloader', 'recovery'

Inputs: mode, device_serial. Returns: result

reset_densityB

Reset density to physical default

Inputs: device_serial. Returns: result

reset_screen_sizeB

Reset screen size to physical default

Inputs: device_serial. Returns: result

rotate_screenB
Rotate screen orientation.
orientation: 'portrait', 'landscape', 'reverse_portrait', 'reverse_landscape', or 'auto'

Inputs: orientation, device_serial. Returns: result

screenshotA

Take a screenshot of the device screen. Returns base64 encoded PNG image that can be viewed directly.

Inputs: device_serial.

screenshot_to_fileB

Save screenshot to a local file

Inputs: filename, device_serial. Returns: result

scroll_downB

Scroll down on the current screen

Inputs: device_serial. Returns: result

scroll_to_textB

Scroll until text is found on screen

Inputs: text (required), max_scrolls, device_serial. Returns: result

scroll_upB

Scroll up on the current screen

Inputs: device_serial. Returns: result

send_smsB

Send an SMS to the emulator (emulator only)

Inputs: phone_number (required), message (required), device_serial. Returns: result

set_animation_scaleA

Set animation scale (0 = off, 1 = normal, 0.5 = fast). Useful for speeding up UI tests.

Inputs: scale, device_serial. Returns: result

set_font_scaleA

Set system font scale (0.85 = small, 1.0 = normal, 1.15 = large, 1.3 = largest). Useful for testing font scaling accessibility.

Inputs: scale, device_serial. Returns: result

set_locationB

Set GPS location (works on emulators)

Inputs: latitude (required), longitude (required), device_serial. Returns: result

set_proxyB

Set HTTP proxy for the device - useful for debugging network requests

Inputs: host (required), port (required), device_serial. Returns: result

shell_commandB

Execute an arbitrary ADB shell command. Use with caution - this gives full shell access.

Inputs: command (required), device_serial. Returns: result

simulate_callC

Simulate incoming call (emulator only)

Inputs: phone_number (required), device_serial. Returns: result

start_screen_recordA
Start recording the screen. Max duration is 180 seconds.
Recording runs in background - use stop_screen_record to stop early.

Inputs: duration_seconds, filename, device_serial. Returns: result

stop_screen_recordB

Stop any ongoing screen recording

Inputs: device_serial. Returns: result

swipeC

Swipe from start to end coordinates

Inputs: start_x (required), start_y (required), end_x (required), end_y (required), +2 more. Returns: result

tapC

Tap at screen coordinates (x, y)

Inputs: x (required), y (required), device_serial. Returns: result

tap_elementB

Tap on an element by text or resource ID. More reliable than raw coordinates.

Inputs: text, resource_id, device_serial. Returns: result

toggle_airplane_modeC

Enable or disable airplane mode

Inputs: enable (required), device_serial. Returns: result

toggle_color_inversionB

Enable or disable display color inversion

Inputs: enable (required), device_serial. Returns: result

toggle_high_contrastC

Enable or disable high contrast text

Inputs: enable (required), device_serial. Returns: result

toggle_show_layout_boundsB

Show layout bounds for all views - great for debugging layouts

Inputs: enable (required), device_serial. Returns: result

toggle_show_tapsB

Show visual feedback for taps - useful for demos/recordings

Inputs: enable (required), device_serial. Returns: result

toggle_talkbackB

Enable or disable TalkBack accessibility service

Inputs: enable (required), device_serial. Returns: result

toggle_wifiC

Enable or disable WiFi

Inputs: enable (required), device_serial. Returns: result

uninstall_appC

Uninstall an app

Inputs: package_name (required), device_serial. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 77 tools

    Disambiguation2/5

    Multiple tools have overlapping or unclear boundaries, causing potential confusion. For example, 'screenshot' and 'capture_screen_for_comparison' both capture screenshots with different metadata purposes, 'clear_text_field' and 'input_text' both handle text input but with different actions, and 'tap' vs 'tap_element' vs 'find_element_by_id/text' create redundancy in UI interaction methods. While descriptions help, the sheer number of similar tools makes disambiguation challenging.

    Naming Consistency4/5

    Tool names follow a mostly consistent snake_case verb_noun pattern (e.g., 'get_device_info', 'install_apk', 'toggle_wifi'), with clear action-oriented naming. There are minor deviations like 'shell_command' (which could be 'execute_shell_command' for full consistency) and some tools use gerunds ('scrolling') while others use base verbs ('tap'), but overall the naming is predictable and readable across the set.

    Tool Count1/5

    With 77 tools, this is an extreme mismatch for an MCP server. The count is excessive and will overwhelm agents, making tool selection difficult and inefficient. While the domain (Android device testing/debugging) is broad, many tools could be consolidated (e.g., multiple screenshot methods, various toggle functions) or handled via parameters in fewer, more general tools.

    Completeness5/5

    The tool surface is exceptionally complete for Android device testing and debugging. It covers comprehensive CRUD/lifecycle operations for apps (install, launch, force stop, uninstall), extensive UI interaction (tap, scroll, input), system controls (reboot, proxy, settings), debugging tools (logs, performance, accessibility), and file operations. There are no obvious gaps; agents can perform end-to-end testing workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      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.
      8
      -
    • A
      license
      B
      quality
      F
      maintenance
      Enables Android device control via ADB and scrcpy, including device management, app management, file operations, shell commands, input simulation, screen mirroring, and UI element inspection.
      25
      31 PyPI
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables remote control of Android devices via ADB, including screen operations, input, app management, file transfer, and advanced tools like UI testing and performance analysis.
      25
      MIT