Android MCP Server

Name: Android MCP Server
Author: minhalvp

@minhalvp

Repository

About Android MCP Server

An MCP server that provides control over Android devices via adb

Basic information

Config

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

{
  "mcpServers": {
    "android-mcp-server": {
      "command": "uv",
      "args": [
        "python",
        "install",
        "3.11"
      ]
    }
  }
}

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 MCP Server?

An MCP server that provides programmatic control over Android devices through ADB (Android Debug Bridge). It exposes tools for ADB command execution, screenshot capture, UI layout analysis, and package management, and can be used by MCP clients like Claude Desktop or code editors such as Cursor.

How to use Android MCP Server?

Install dependencies with uv and configure an optional config.yaml for device selection when multiple devices are connected. Then add the server to your MCP client’s configuration (e.g., claude_desktop_config.json) by providing the path to uv and the server directory with the arguments ["--directory", "path/to/android-mcp-server", "run", "server.py"].

Key features of Android MCP Server

🔧 ADB Command Execution
📸 Device Screenshot Capture
🎯 UI Layout Analysis
📱 Device Package Management
Flexible device configuration (auto or manual)

Use cases of Android MCP Server

Automate Android device testing via ADB commands
Capture screenshots for debugging or documentation
Analyze UI layout to locate clickable elements
Manage installed packages (list, inspect actions)
Execute arbitrary ADB commands from an MCP client

FAQ from Android MCP Server

What prerequisites are needed to run Android MCP Server?

Python 3.x and ADB (Android Debug Bridge) must be installed. An Android device or emulator is required (emulator not tested).

Is a configuration file required for Android MCP Server?

No. The config.yaml file is optional. If only one device is connected, the server auto-selects it. For multiple devices, you must specify the device serial in config.yaml.

What tools does Android MCP Server provide?

The server exposes five tools: get_packages, execute_adb_command, get_uilayout, get_screenshot, and get_package_action_intents.

How do I connect Android MCP Server to Claude Desktop?

Add a configuration entry in claude_desktop_config.json under mcpServers with the command set to the path of uv and args including ["--directory", "path/to/android-mcp-server", "run", "server.py"].