MCP Android Server
MCP Android agent - 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 A
What is MCP Android Server?
MCP Android Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp android agent - 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 copi...
MCP Android agent - 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 A
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Android agent - This project provides an *MCP (Model Con
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-android-server-pythonConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Android Server
MCP Android Server is a Python-based Model Context Protocol server that lets AI agents like Claude, GitHub Copilot Chat, and Open Interpreter control real Android devices through natural language commands. It uses uiautomator2 under the hood to drive device interactions, and exposes a modular set of tools covering device management, app lifecycle, screen control, user input simulation, UI inspection, and advanced features like toast detection and activity monitoring. Teams use it to build AI-driven QA pipelines, remote device control setups, and Android automation bots.
Prerequisites
- Python 3.13 or higher
- Android Debug Bridge (adb) installed and available on PATH
- An Android device or emulator with USB debugging enabled and uiautomator2 compatibility
- uv package manager (https://github.com/astral-sh/uv) for dependency management
- An MCP-compatible client such as Claude Desktop or GitHub Copilot Chat
Clone the repository
Clone the mcp-android-server-python repository to your local machine and navigate into the project directory.
git clone https://github.com/nim444/mcp-android-server-python.git
cd mcp-android-server-pythonCreate and activate a virtual environment
Use uv to create an isolated Python 3.13 virtual environment and activate it.
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activateInstall dependencies
Install all required Python packages including uiautomator2 and the MCP SDK using uv.
uv pip install -r requirements.txtConnect your Android device
Enable USB debugging on your Android device (Settings > Developer Options > USB Debugging), connect it via USB, and verify adb detects it.
adb devicesConfigure the transport mode
Open server.py and ensure the stdio transport section is active (uncomment the stdio block and comment out the HTTP block) for use with MCP clients like Claude Desktop.
Run the MCP server
Start the server in stdio mode so your MCP client can communicate with it.
uv run python server.pyAdd the server to your MCP client configuration
Register the server in your claude_desktop_config.json so Claude Desktop can launch and connect to it automatically.
MCP Android Server Examples
Client configuration
Add this to your claude_desktop_config.json to connect Claude Desktop to the Android MCP server.
{
"mcpServers": {
"android": {
"command": "/path/to/mcp-android-server-python/.venv/bin/python",
"args": ["/path/to/mcp-android-server-python/server.py"]
}
}
}Prompts to try
Once connected, use these natural language prompts to control your Android device through Claude.
- "Take a screenshot of the current screen on the connected Android device"
- "Open the Settings app on the Android device"
- "Click on the Wi-Fi option in the Settings screen"
- "Swipe up on the screen to scroll down"
- "List all installed apps on the device"
- "Get the current battery level and Android version of the connected device"Troubleshooting MCP Android Server
adb devices shows 'unauthorized' for the connected device
Unlock your Android device and accept the RSA fingerprint prompt that appears when you plug in via USB. If no prompt appears, revoke USB debugging authorizations in Developer Options and reconnect.
uiautomator2 fails to connect or throws a connection error
Run 'python -m uiautomator2 init' while your device is connected to push the uiautomator2 server APK to the device. Ensure the device screen is unlocked and not in a restricted profile.
Server exits immediately when launched from Claude Desktop
Make sure the stdio transport block is active in server.py (not the HTTP block). Verify the Python path in the MCP config points to the virtualenv interpreter, not the system Python.
Frequently Asked Questions about MCP Android Server
What is MCP Android Server?
MCP Android Server is a Model Context Protocol (MCP) server that mcp android agent - 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 a It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Android Server?
Follow the installation instructions on the MCP Android Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Android Server?
MCP Android Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Android Server free to use?
Yes, MCP Android Server is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Android Server Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCP Android Server? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Android Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Android Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.