MCP Android Server Python MCP Server

This project provides an **MCP (Model Context Protocol)** server for automating Android devices using

Local serverstdioPython

What is the MCP Android Server Python MCP Server?

This project provides an MCP (Model Context Protocol) server for automating Android devices using uiautomator2. It's designed to be easily plugged into AI agents like GitHub Copilot Chat, Claude, or Open Interpreter to control Android devices through.

What MCP Android Server Python does

This project provides an MCP (Model Context Protocol) server for automating Android devices using uiautomator2. It's designed to be easily plugged into AI agents like GitHub Copilot Chat, Claude, or Open Interpreter to control Android devices through natural language.

Requirements

  • Python 3.13 or higher - Android Debug Bridge (adb) installed and in PATH - Connected Android device with USB debugging enabled - uiautomator2 compatible Android device

Practical notes

  • Maintained by nim444, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
mcp_healthCheck if the MCP server is running properly
get_device_statusGet complete device status and readiness information
connect_deviceConnect to an Android device and get basic info
get_device_infoGet detailed device info: serial, resolution, battery, etc.
check_adb_and_list_devicesCheck if ADB is installed and list connected devices
get_installed_appsList all installed apps with version and package info
get_current_appGet info about the app currently in the foreground
start_appStart an app by its package name
stop_appStop an app by its package name
stop_all_appsStop all currently running apps
clear_app_dataClear user data/cache of a specified app
screen_onTurn on the screen
screen_offTurn off the screen
unlock_screenUnlock the screen (turn on and swipe if necessary)

How to install the MCP Android Server Python MCP Server

{
  "mcpServers": {
    "mcp-android": {
      "type": "stdio",
      "command": "bash",
      "args": [
        "-c",
        "cd /path/to/mcp-adb && source .venv/bin/activate && uv run python server.py"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.13 or higher - Android Debug Bridge (adb) installed and in PATH - Connected Android device with USB debugging enabled - uiautomator2 compatible Android device

Example prompts to try

  • “Use MCP Android Server Python to mcp health.”
  • “Use MCP Android Server Python to get device status.”
  • “Use MCP Android Server Python to connect device.”

Frequently asked questions

This project provides an **MCP (Model Context Protocol)** server for automating Android devices using [uiautomator2](https://github.com/openatx/uiautomator2). It's Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.