Android MCP
A lightweight bridge enabling AI agents to perform real-world tasks on Android devices such as app navigation, UI interaction, and automated QA testing without requiring computer-vision pipelines or preprogrammed scripts.
What is Android MCP?
Android MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to lightweight bridge enabling ai agents to perform real-world tasks on android devices such as app navigation, ui interaction, and automated qa testing without requiring computer-vision pipelines or pre...
A lightweight bridge enabling AI agents to perform real-world tasks on Android devices such as app navigation, UI interaction, and automated QA testing without requiring computer-vision pipelines or preprogrammed scripts.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A lightweight bridge enabling AI agents to perform real-worl
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx android-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Android MCP
Android MCP is an open-source bridge that lets AI agents control Android devices and emulators through ADB and the Android Accessibility API without requiring computer-vision pipelines or pre-scripted automation. It runs as an MCP server, exposing tools for launching apps, tapping, swiping, inputting text, reading view hierarchies, capturing screenshots, and executing shell commands. Developers and QA engineers can use it to automate end-to-end mobile testing, navigate apps conversationally, or let an LLM agent perform real-world Android tasks on their behalf.
Prerequisites
- Python 3.13 (required; Python 3.14 has a known dependency issue on Windows)
- ADB (Android Debug Bridge) installed and accessible on PATH
- An Android 10+ device with USB Debugging enabled, or a running Android emulator
- uvx installed (from the uv Python toolchain) for the recommended setup
- An MCP client such as Claude Desktop
Install ADB and verify device connection
Install Android platform-tools for your OS and confirm ADB can see your device or emulator before configuring the server.
adb devices
# Expected output:
# List of devices attached
# emulator-5554 deviceConnect via Wi-Fi (optional)
If you prefer a wireless connection instead of USB, connect your device to ADB over TCP/IP on port 5555.
adb connect 192.168.1.3:5555
adb devicesAdd the server to Claude Desktop configuration
Edit your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows) to add the android-mcp entry using uvx.
Configure Wi-Fi device environment variables (if needed)
If your device is connected over Wi-Fi rather than USB, add ANDROID_MCP_CONNECTION and ANDROID_MCP_HOST to the env block in your MCP config so the server targets the correct IP address.
Restart Claude Desktop
Restart Claude Desktop to load the new server. The server connects lazily on first tool call and will auto-detect the first available ADB device if no specific device is configured.
Android MCP Examples
Client configuration
Claude Desktop configuration for Android MCP using uvx with Python 3.13. Includes optional Wi-Fi device environment variables.
{
"mcpServers": {
"android-mcp": {
"command": "uvx",
"args": ["--python", "3.13", "android-mcp"],
"env": {
"ANDROID_MCP_CONNECTION": "wifi",
"ANDROID_MCP_HOST": "192.168.1.3"
}
}
}
}Prompts to try
Example prompts that leverage the Android MCP's device control tools.
- "Open the Settings app and navigate to Wi-Fi settings"
- "Take a screenshot of the current screen and describe what's on it"
- "Type 'hello world' into the focused text field and press Enter"
- "Swipe up three times to scroll through the app list and find the Calculator app"
- "Run the shell command 'pm list packages' and show me all installed packages"Troubleshooting Android MCP
ADB device shows as 'unauthorized' or does not appear
On the Android device, check the notification shade or USB debugging prompt and tap 'Allow' to authorize your computer's RSA key. If the prompt never appears, try a different USB cable or port, then run 'adb kill-server && adb start-server'.
Server fails to start on Windows with Python 3.14
Python 3.14 has a known transitive dependency issue with pywin32 on Windows. Use Python 3.13 explicitly by passing --python 3.13 to uvx as shown in the configuration example.
Tools time out or actions do not appear on screen
Typical action latency is 2-4 seconds. If tools consistently time out, ensure the device is not in sleep mode, check that USB debugging is still enabled, and verify the ADB connection is stable with 'adb devices'.
Frequently Asked Questions about Android MCP
What is Android MCP?
Android MCP is a Model Context Protocol (MCP) server that lightweight bridge enabling ai agents to perform real-world tasks on android devices such as app navigation, ui interaction, and automated qa testing without requiring computer-vision pipelines or preprogrammed scripts. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Android MCP?
Follow the installation instructions on the Android MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Android MCP?
Android MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Android MCP free to use?
Yes, Android MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Android MCP Alternatives — Similar Browser Automation Servers
Looking for alternatives to Android MCP? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Android MCP 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 Android MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.