ADB MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ADB MCP Server list connected devices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ADB MCP Server
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.jsonWindows:
%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:
Open the Agent Panel in the top right.
Select Manage MCP Servers or go to Settings → Customizations.
Add a custom MCP server:
Command:
npxArguments:
-y adb-mcp-server
Cursor
Open Settings → Features → MCP
Click + Add New MCP Server
Set:
Name:
adbType:
commandCommand:
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-serverExample 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 toolsclear_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.
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.
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
Scored across 42 tools
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.
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.
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.
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
Related MCP Connectors
Give your AI agent a real cloud Android phone: push APKs, drive it, get screenshots and logs.
Disposable cloud Android emulators for coding agents: run an APK or PR build, tap, type, screenshot.
Drive real Android & iOS devices and web browsers from natural language for mobile + web QA. 290+ tools across device control, app management, automation sessions, browser automation, and flow recording / replay. Bearer-auth — get a token at robotactions.com → Profile → API Tokens.
Rent a real Android phone: install your build, see the screen, tap, type and read Logcat.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables control of Android devices via ADB for automation and testing. Supports app management, screen capture, UI analysis, and input simulation through natural language commands.9170 npm38MIT
- AlicenseCqualityDmaintenanceEnables 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.77MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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 npm8ISC
- AlicenseBqualityDmaintenanceEnables 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.42200 npm22MIT