UIAutomator2 MCP Server

UIAutomator2 MCP Server is an MCP server that connects LLM clients to Android devices using the UIAutomator2 testing framework and Android Debug Bridge. Built with FastMCP, it is intended for mobile developers, QA automation engineers, and AI agent builders who need to control Android applications and hardware programmatically. The server enables an AI agent to execute low-level ADB commands, manage installed packages, capture screen images, and inspect live device state. It also exposes high-level user interface actions such as tapping on UI elements by text or selector, typing text strings, swiping across the screen, scrolling through lists, and waiting for UI components to appear. By bridging Claude or other MCP-compatible assistants to physical devices or emulators, it provides the capabilities needed to run automated mobile test workflows, verify app behaviors, and execute device operations through plain text instructions.

Category: Browser & Web Automation

Tags: android, mobile-automation, testing, uiautomator2

Visit UIAutomator2 MCP Server

How to install and configure UIAutomator2 MCP Server

1. Ensure Python 3.10 or higher, ADB tools, and an active Android device or emulator are configured. 2. Clone the repository and install dependencies: bash git clone https://github.com/GitDzreal93/uiautomator2-mcp.git cd uiautomator2-mcp pip install -e . 3. Open your client configuration file, such as ~/.cursor/mcp.json or Claude Desktop's mcp.json, and register the server: json { "mcpServers": { "android": { "command": "uv", "args": [ "--directory", "/path/to/uiautomator2-mcp", "run", "src/server.py" ] } } } 4. Alternatively, configure the command to run with python pointing directly to /path/to/uiautomator2-mcp/src/server.py.

What you can do with UIAutomator2 MCP Server

• Running automated mobile test suites by launching Android applications and navigating multi-step login or registration forms. - Capturing device screenshots and inspecting current application states to diagnose UI layout issues and runtime crashes. - Executing direct ADB operations and package management commands across connected physical phones and Android Virtual Devices. - Testing deep links and screen transitions by driving automated clicks, text entry, and swipe interactions via natural language. - Automating routine mobile QA verification runs by orchestrating UIAutomator2 services and waiting for UI elements to load.

Key facts

• Open Source
• https://github.com/GitDzreal93/uiautomator2-mcp
• Browser & Web Automation, Cloud & Infrastructure
• android, mobile-automation, testing, uiautomator2

Part of MCP Servers

What is UIAutomator2 MCP Server?

UIAutomator2 MCP Server is an open source server built on the FastMCP framework. It exposes Android device control and UIAutomator2 automation capabilities directly to Model Context Protocol clients, allowing AI agents to perform tasks like clicking elements, typing input, capturing screenshots, and running ADB commands on connected Android devices or emulators.

What requirements are needed to run UIAutomator2 MCP Server?

The server requires Python 3.10 or higher, the Android Debug Bridge command-line tool installed and reachable in your environment, and an active physical Android device or emulator connected via ADB.

Which MCP clients work with UIAutomator2 MCP Server?

It works with MCP-compatible clients including Claude Desktop and Cursor. Users configure the server entry inside their client configuration file using uv or direct Python commands pointing to the server entry point.

Is UIAutomator2 MCP Server open source?

Yes, UIAutomator2 MCP Server is open source and distributed under the MIT License on GitHub.