Android

v1.2.1Browser Automationstable

📇 🏠 - 21-tool Android device control via ADB — screenshots with comp

mcpandroidadbemulatorclaude
Share:
40
Stars
0
Downloads
0
Weekly
0/5

What is Android?

Android is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 🏠 - 21-tool android device control via adb — screenshots with comp

📇 🏠 - 21-tool Android device control via ADB — screenshots with comp

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP protocol support

Use Cases

Control Android devices via ADB with 21 tools.
Capture screenshots with component annotations.
Automate UI testing on Android emulators.
martingeidobler

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.2.1
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y android-mcp-server

Manual Installation

npx -y android-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Android

android-mcp-server gives AI assistants direct control over Android devices and emulators through a 25-tool MCP interface built on top of ADB (Android Debug Bridge). It supports taking annotated screenshots with UI component overlays, interacting with UI elements by tap/swipe/type/key-press, managing apps, reading device logs, and running arbitrary ADB shell commands — making it ideal for automated UI testing, bug documentation, and AI-driven Android app exploration. The server auto-discovers the Android SDK on macOS at ~/Library/Android/sdk if ANDROID_HOME is not explicitly set.

Prerequisites

  • Node.js 18 or higher installed
  • Android SDK with platform-tools (ADB) installed
  • A running Android emulator or a physical device connected via USB with USB debugging enabled
  • ANDROID_HOME environment variable set (or Android SDK at ~/Library/Android/sdk on macOS)
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Install the Android SDK and ADB

Install Android Studio or the standalone command-line tools to get ADB. Verify ADB can see your device or emulator.

adb devices
# Should list your emulator or connected device
2

Add the server via Claude Code (recommended)

Use the claude mcp add command for the quickest setup. Claude Code will run the server via npx automatically.

claude mcp add --scope user android -- npx -y android-mcp-server
# With a custom SDK path:
# claude mcp add --scope user --env ANDROID_HOME=/path/to/sdk android -- npx -y android-mcp-server
3

Or configure Claude Desktop manually

If you use Claude Desktop rather than Claude Code, add the server configuration to your claude_desktop_config.json file.

4

Restart your MCP client

Restart Claude Desktop or reload Claude Code so the new server configuration is picked up.

5

Verify the connection

Ask Claude to list connected devices to confirm the server is running and ADB can see your target device.

Android Examples

Client configuration

Claude Desktop configuration for android-mcp-server. On macOS the SDK is typically at ~/Library/Android/sdk — adjust ANDROID_HOME to match your installation.

{
  "mcpServers": {
    "android": {
      "command": "npx",
      "args": ["-y", "android-mcp-server"],
      "env": {
        "ANDROID_HOME": "/Users/yourname/Library/Android/sdk"
      }
    }
  }
}

Prompts to try

Sample prompts demonstrating device control, screenshot capture, app interaction, and log analysis.

- "Take a screenshot of the current Android screen and describe what's visible"
- "Launch the Settings app, tap on 'Battery', and take a screenshot showing battery usage"
- "Clear the app logs for com.example.myapp, trigger the crash scenario, then show me the error logs"
- "List all connected Android devices and emulators and tell me which one is running"

Troubleshooting Android

ADB device not found or 'no devices/emulators found' error

Run adb devices in a terminal. If the list is empty, ensure your emulator is fully booted or your physical device has USB debugging enabled and has accepted the RSA key prompt. Also confirm ADB is in your PATH.

ANDROID_HOME not set or SDK not found

Set the ANDROID_HOME environment variable in the MCP client config env block to the absolute path of your Android SDK (the directory containing platform-tools/adb). On macOS this is typically ~/Library/Android/sdk.

Screenshots succeed but UI element taps hit the wrong location

Use the get_ui_tree tool first to retrieve the current UI element hierarchy and their bounding boxes, then use tap_element with the element identifier rather than raw screen coordinates.

Frequently Asked Questions about Android

What is Android?

Android is a Model Context Protocol (MCP) server that 📇 🏠 - 21-tool android device control via adb — screenshots with comp It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Android?

Install via npm with the command: npx -y android-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

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 MIT License license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

{ "mcpServers": { "android": { "command": "npx", "args": ["-y", "android-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides