Android ADB MCP Server

Name: Android ADB MCP Server
Author: landicefu

@landicefu

Repository

About Android ADB MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Android ADB MCP Server?

Android ADB MCP Server is a Model Context Protocol server that enables AI assistants to interact with Android devices through the Android Debug Bridge (ADB). It bridges AI capabilities with Android device management for automation of development and testing operations.

How to use Android ADB MCP Server?

Add the server to your MCP configuration file (e.g., Claude Desktop or Cline/Roo Code settings) using the npx command npx -y @landicefu/android-adb-mcp-server. After configuration, restart the AI assistant to load the server. The server exposes tools for shell commands, app management, file transfer, and screenshots with automatic or explicit device selection.

Key features of Android ADB MCP Server

Connect to and manage multiple Android devices
Execute shell commands on Android devices
Install and uninstall applications
Push and pull files between local system and Android devices
Launch applications on Android devices
Take screenshots and save locally or copy to clipboard

Use cases of Android ADB MCP Server

Automate app testing by installing, launching, and uninstalling packages across devices
Capture device screenshots during test runs and save them to disk or clipboard
Execute adb shell commands for debugging or monitoring device state
Transfer files (APKs, test data) between development machine and Android devices
Manage multiple connected devices with intelligent device selection

FAQ from Android ADB MCP Server

What are the prerequisites for using Android ADB MCP Server?

ADB must be installed and available in your system PATH. Node.js 16.x or higher is required. For clipboard screenshot functionality, macOS uses osascript (built-in), Windows uses PowerShell (built-in), and Linux requires xclip installed via package manager.

How do I configure Android ADB MCP Server in my AI assistant?

Add a JSON entry to your MCP configuration file with command npx and args ["-y", "@landicefu/android-adb-mcp-server"]. Configuration file locations vary: for Claude Desktop on macOS it is ~/Library/Application Support/Claude/claude_desktop_config.json; for Cline/Roo Code check the equivalent application support directories.

How does device selection work when multiple Android devices are connected?

If only one device is connected, it is used automatically. If multiple devices are connected, you must specify a device_id parameter in the tool call. If no devices are connected, an error is returned. Use the adb_devices tool to list connected devices.

What should I do if I get an "ADB is not available" error?

Ensure ADB is installed and in your system PATH. Verify by running adb version in your terminal. If the device is not detected, check that USB debugging is enabled, or try restarting ADB with adb kill-server followed by adb start-server.

How are screenshot output paths resolved?

Absolute paths are used as-is. Paths starting with ~ are expanded to the user's home directory. Relative paths are resolved relative to the user's home directory. This ensures write permissions for the MCP server.