An MCP server that provides control over Android devices through ADB. Offers device screenshot capture, UI layout analysis, package management, and ADB command execution capabilities.
An MCP (Model Context Protocol) server that provides programmatic control over Android devices through ADB (Android Debug Bridge). This server exposes various Android device management capabilities that can be accessed by MCP clients like Claude desktop and Code editors (e.g. Cursor)
git clone https://github.com/minhalvp/android-mcp-server.git
cd android-mcp-server
uv python install 3.11
uv sync
The server supports flexible device configuration with multiple usage scenarios.
1. Automatic Selection (Recommended for single device)
2. Manual Device Selection
The configuration file (config.yaml
) is optional. If not present, the server will automatically select the device if only one is connected.
Simply ensure only one device is connected and run the server - no configuration needed!
cp config.yaml.example config.yaml
config.yaml
and specify your device:device:
name: "your-device-serial-here" # Device identifier from 'adb devices'
For auto-selection, you can use any of these methods:
device:
name: null # Explicit null (recommended)
# name: "" # Empty string
# name: # Or leave empty/comment out
To find your device identifier, run:
adb devices
Example output:
List of devices attached
13b22d7f device
emulator-5554 device
Use the first column value (e.g., 13b22d7f
or emulator-5554
) as the device name.
Scenario | Configuration Required | Behavior |
---|---|---|
Single device connected | None | ✅ Auto-connects to the device |
Multiple devices, want specific one | config.yaml with device.name | ✅ Connects to specified device |
Multiple devices, no config | None | ❌ Shows error with available devices |
No devices connected | N/A | ❌ Shows "no devices" error |
Note: If you have multiple devices connected and don't specify which one to use, the server will show an error message listing all available devices.
An MCP client is needed to use this server. The Claude Desktop app is an example of an MCP client. To use this server with Claude Desktop:
Locate your Claude Desktop configuration file:
%APPDATA%\Claude\claude_desktop_config.json
~/Library/Application Support/Claude/claude_desktop_config.json
Add the Android MCP server configuration to the mcpServers
section:
{
"mcpServers": {
"android": {
"command": "path/to/uv",
"args": ["--directory", "path/to/android-mcp-server", "run", "server.py"]
}
}
}
Replace:
path/to/uv
with the actual path to your uv
executablepath/to/android-mcp-server
with the absolute path to where you cloned this
repositoryhttps://github.com/user-attachments/assets/c45bbc17-f698-43e7-85b4-f1b39b8326a8
The server exposes the following tools:
def get_packages() -> str:
"""
Get all installed packages on the device.
Returns:
str: A list of all installed packages on the device as a string
"""
def execute_adb_command(command: str) -> str:
"""
Executes an ADB command and returns the output.
Args:
command (str): The ADB command to execute
Returns:
str: The output of the ADB command
"""
def get_uilayout() -> str:
"""
Retrieves information about clickable elements in the current UI.
Returns a formatted string containing details about each clickable element,
including their text, content description, bounds, and center coordinates.
Returns:
str: A formatted list of clickable elements with their properties
"""
def get_screenshot() -> Image:
"""
Takes a screenshot of the device and returns it.
Returns:
Image: the screenshot
"""
def get_package_action_intents(package_name: str) -> list[str]:
"""
Get all non-data actions from Activity Resolver Table for a package
Args:
package_name (str): The name of the package to get actions for
Returns:
list[str]: A list of all non-data actions from the Activity Resolver
Table for the package
"""
Contributions are welcome!
A terminal AI chat interface for any LLM model, with file context, MCP, and deployment support.
A template for deploying a remote MCP server on Cloudflare Workers, customizable by defining tools in the source code.
Enable AI agents to interact with the Atla API for state-of-the-art LLMJ evaluation.
Automate and control Android devices using the UIAutomator2 framework.
A server providing tools for Xcode project management, simulator management, and app utilities.
An MCP client for Cursor that uses OpenRouter.ai to access multiple AI models. Requires an OpenRouter API key.
A local MCP server implementing Retrieval-Augmented Generation (RAG) with sentence window retrieval and support for multiple file types.
A Python client for connecting to Model Context Protocol (MCP) servers, supporting local scripts and npx packages.
Interact with various build systems including Gradle, Maven, NPM/Yarn, Cargo, Python, Makefile, and CMake.
Search Android Vehicle Hardware Abstraction Layer (vHAL) documentation and source code from a local repository clone.