Android
Enables AI agents to fully control Android devices through over 30 tools for app management, UI automation, and vision-based analysis via ADB. It supports multi-device management, action recording, and smart execution strategies ranging from UI hiera
What is Android?
Android is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai agents to fully control android devices through over 30 tools for app management, ui automation, and vision-based analysis via adb. it supports multi-device management, action recording, an...
Enables AI agents to fully control Android devices through over 30 tools for app management, UI automation, and vision-based analysis via ADB. It supports multi-device management, action recording, and smart execution strategies ranging from UI hiera
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI agents to fully control Android devices through o
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx android-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Android
Android MCP Server is a Python-based Model Context Protocol server that gives AI agents programmatic control over Android devices and emulators through ADB (Android Debug Bridge), exposing tools for executing shell commands, capturing screenshots, analyzing UI layouts, and managing installed packages. It supports automatic device selection when a single device is connected and allows explicit device targeting via a YAML config file when multiple devices are present. Mobile developers, QA engineers, and automation researchers use it to let Claude operate Android devices with natural language — installing apps, inspecting UI hierarchies, taking screenshots, and running diagnostic commands.
Prerequisites
- Python 3.11 or later
- uv package manager (https://docs.astral.sh/uv/getting-started/installation/)
- ADB (Android Debug Bridge) installed and on your PATH — part of Android SDK Platform Tools
- An Android device with USB debugging enabled, or a running Android emulator
- An MCP client such as Claude Desktop or Cursor
Install ADB and verify device connectivity
ADB must be installed and your device must appear when you run adb devices. Install Android SDK Platform Tools from developer.android.com or via your package manager, then enable USB debugging on your device.
adb devicesClone the android-mcp-server repository
Clone the repository to a permanent location; the MCP config will reference this path.
git clone https://github.com/minhalvp/android-mcp-server.git
cd android-mcp-serverInstall Python dependencies with uv
Use uv to install Python 3.11 and sync project dependencies into the project's virtual environment.
uv python install 3.11
uv syncOptional: create a device config for multi-device setups
If more than one device is connected, copy the example config and specify your target device serial (from `adb devices`).
cp config.yaml.example config.yaml
# Edit config.yaml and set: device:
# name: "your-device-serial"Add the server to your MCP client configuration
Edit your claude_desktop_config.json to point to the uv executable and the cloned repository directory. Use absolute paths.
{
"mcpServers": {
"android": {
"command": "/path/to/uv",
"args": [
"--directory",
"/path/to/android-mcp-server",
"run",
"server.py"
]
}
}
}Restart Claude Desktop and verify tools are available
Fully quit and reopen Claude Desktop. The Android MCP tools (adb command execution, screenshot capture, UI layout analysis, package management) should appear in the tool list.
Android Examples
Client configuration
claude_desktop_config.json entry. Replace paths with the actual location of your uv binary and the cloned repository.
{
"mcpServers": {
"android": {
"command": "/Users/yourname/.local/bin/uv",
"args": [
"--directory",
"/Users/yourname/projects/android-mcp-server",
"run",
"server.py"
]
}
}
}Prompts to try
Natural language commands that map to the ADB shell, screenshot, UI analysis, and package management tools.
- "Take a screenshot of the current Android screen"
- "List all installed apps on the connected device"
- "Analyze the current UI layout and describe what's on screen"
- "Install the APK at /tmp/myapp.apk on the connected device"
- "Run `adb shell dumpsys battery` and show me the battery status"
- "Open the Settings app on the device"Troubleshooting Android
Server fails with 'no devices/emulators found'
Run `adb devices` in your terminal and confirm your device appears as 'device' (not 'unauthorized'). If unauthorized, accept the USB debugging prompt on the device. Ensure USB debugging is enabled in Developer Options.
Multiple devices connected causes an error
Copy config.yaml.example to config.yaml in the repository directory and set `device.name` to the serial number of your target device (first column of `adb devices` output).
uv or server.py path not found in Claude Desktop
Use absolute paths in claude_desktop_config.json. Find the uv binary path with `which uv` and the repository path with `pwd` from inside the cloned directory. Claude Desktop does not inherit shell PATH variables.
Frequently Asked Questions about Android
What is Android?
Android is a Model Context Protocol (MCP) server that enables ai agents to fully control android devices through over 30 tools for app management, ui automation, and vision-based analysis via adb. it supports multi-device management, action recording, and smart execution strategies ranging from ui hiera It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Android?
Follow the installation instructions on the Android GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Android?
Android works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Android free to use?
Yes, Android is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Android Alternatives — Similar Browser Automation Servers
Looking for alternatives to Android? 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 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?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.