Android ADB MCP Server

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.