Android ADB MCP Server logo

Android ADB MCP Server

by landicefu

A Model Context Protocol (MCP) server that enables AI assistants to interact with Android devices through the Android Debug Bridge (ADB). This server bridges the gap between AI capabilities and Android device management, allowing for seamless automation of Android development and testing operations.

View on GitHub

Last updated: N/A

What is Android ADB MCP Server?

The Android ADB MCP Server is a Model Context Protocol server that allows AI assistants to control and interact with Android devices via ADB. It acts as a bridge, enabling AI to automate tasks on Android devices for development, testing, and other purposes.

How to use Android ADB MCP Server?

To use the server, add its configuration to your MCP configuration file (e.g., claude_desktop_config.json). Ensure ADB is installed and in your system PATH. Restart your AI assistant to load the new server configuration. Then, use the available tools (e.g., adb_shell, adb_install) with appropriate parameters.

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 them locally or copy to clipboard

  • Smart device selection when multiple devices are connected

Use cases of Android ADB MCP Server

  • Automated Android testing

  • Remote device management

  • Application installation and uninstallation

  • Data transfer between device and computer

  • Screenshot capture for documentation

  • AI-driven Android application control

FAQ from Android ADB MCP Server

ADB is not available error

Ensure ADB is installed and in your system PATH. Verify by running adb version in your terminal

No Android devices connected error

Check if your device is properly connected with adb devices. Ensure USB debugging is enabled on your device. Try restarting ADB with adb kill-server followed by adb start-server

Multiple devices connected error

Specify the device_id parameter in your tool call. Get the list of available devices with the adb_devices tool

Screenshot to clipboard not working

Ensure the required platform-specific tools are installed

How do I specify the output path for screenshots?

Absolute paths are used as-is, paths starting with ~ are expanded to the user's home directory, and relative paths are resolved relative to the user's home directory.