Android ADB MCP Server

v1.0.0Browser Automationstable

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 inte

android-adb-mcp-servermcpai-integration
Share:
36
Stars
0
Downloads
0
Weekly
0/5

What is Android ADB MCP Server?

Android ADB MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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-compati...

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 inte

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables programmatic control of Android devices via ADB, sup

Use Cases

Control Android devices via ADB with UI automation, app management, and screen capture with OCR. Transfer files programmatically.
landicefu

Maintainer

LicenseISC License
Languagejavascript
Versionv1.0.0
UpdatedApr 28, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx android-adb-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Android ADB MCP Server

Android ADB MCP Server bridges AI assistants with Android devices over the Android Debug Bridge, enabling LLMs like Claude to automate development and testing workflows without manual ADB commands. It exposes tools for listing connected devices, executing shell commands, installing and uninstalling APKs, managing files, launching applications, and capturing screenshots with OCR. Android developers and QA engineers use it to let Claude drive device testing, investigate app behaviour, and automate repetitive device interactions.

Prerequisites

  • Node.js 18 or later installed
  • Android Debug Bridge (ADB) installed and in your PATH — part of the Android SDK Platform Tools
  • An Android device or emulator with USB debugging enabled and authorised
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Install ADB and enable USB debugging

Download Android SDK Platform Tools from developer.android.com and ensure 'adb' is available in your terminal. On your Android device go to Settings > Developer options and enable USB Debugging, then connect via USB and accept the authorisation prompt.

adb devices
2

Verify device connection

Run adb devices to confirm your device appears as 'device' (not 'unauthorized'). Only proceed once the device is fully authorised.

adb devices
# Expected output:
# List of devices attached
# emulator-5554   device
3

Add the server to Claude Desktop config

Edit claude_desktop_config.json to register the Android ADB MCP server using the scoped npm package.

{
  "mcpServers": {
    "android-adb": {
      "command": "npx",
      "args": ["-y", "@landicefu/android-adb-mcp-server"]
    }
  }
}
4

Restart Claude Desktop

Fully quit and reopen Claude Desktop so it starts the ADB MCP server process.

5

Use the exposed ADB tools

The server exposes: adb_devices, adb_shell, adb_install, adb_uninstall, adb_list_packages, adb_pull, adb_push, launch_app, take_screenshot_and_save, and take_screenshot_and_copy_to_clipboard. Ask Claude to use these to interact with your connected Android device.

Android ADB MCP Server Examples

Client configuration

Claude Desktop configuration block for the Android ADB MCP server.

{
  "mcpServers": {
    "android-adb": {
      "command": "npx",
      "args": ["-y", "@landicefu/android-adb-mcp-server"],
      "env": {},
      "disabled": false
    }
  }
}

Prompts to try

Example prompts that drive Android device automation through Claude.

- "List all Android devices currently connected via ADB."
- "Take a screenshot of my device and describe what's on the screen."
- "Install the APK at /Users/me/Downloads/myapp.apk on the connected device."
- "List all installed packages on my Android device and find any related to 'camera'."
- "Launch the Settings app on the connected device."
- "Pull the file /sdcard/DCIM/photo.jpg from the device and save it to my desktop."

Troubleshooting Android ADB MCP Server

adb_devices returns an empty list or 'unauthorized' device

Ensure USB debugging is enabled on the device under Settings > Developer Options. Disconnect and reconnect the USB cable, then accept the 'Allow USB debugging?' prompt on the device screen. Run 'adb kill-server && adb start-server' to reset the ADB daemon.

npx fails to find @landicefu/android-adb-mcp-server

Ensure you have a working npm registry connection. Run 'npm view @landicefu/android-adb-mcp-server' to confirm the package exists. If behind a corporate proxy set npm's proxy settings with 'npm config set proxy http://...'.

take_screenshot_and_save produces a blank or black image

Some apps block screenshots via FLAG_SECURE. Try with a different app. Also check that the device screen is unlocked and active — a locked or sleeping screen may produce a blank capture.

Frequently Asked Questions about Android ADB MCP Server

What is Android ADB MCP Server?

Android ADB MCP Server is a Model Context Protocol (MCP) server that 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 inte It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Android ADB MCP Server?

Follow the installation instructions on the Android ADB MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Android ADB MCP Server?

Android ADB MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Android ADB MCP Server free to use?

Yes, Android ADB MCP Server is open source and available under the ISC License license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Android ADB MCP Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides