How to add Android MCP Server to Claude Desktop

Control Android devices from MCP clients via ADB — run shell commands, capture screenshots, inspect UI, manage packages. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 771★ · stdio · no auth

Claude Desktop config for Android MCP Server

git clone https://github.com/minhalvp/android-mcp-server.git

{
  "mcpServers": {
    "android-mcp-server": {
      "command": "path/to/uv",
      "args": [
        "--directory",
        "path/to/android-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Android MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Android MCP Server's tools appear under the 🔌 tools menu.

Before you start

Python 3.x (uv can install Python 3.11)
uv (Astral) for project/dependency management
ADB (Android Debug Bridge) installed and configured
An Android device or emulator with USB debugging enabled and authorized
An MCP client such as Claude Desktop or Cursor

What Android MCP Server can do in Claude Desktop

get_packages

Get all installed packages on the device, returned as a string list.

execute_adb_command

Execute an arbitrary ADB command and return its output.

get_uilayout

Retrieve information about clickable elements in the current UI, including text, content description, bounds, and center coordinates.

get_screenshot

Take a screenshot of the device and return it as an image.

get_package_action_intents

Get all non-data actions from the Activity Resolver Table for a given package name.

Security

The execute_adb_command tool runs arbitrary ADB commands against the connected device, giving the MCP client broad control over the device (shell access, package management, etc.). Only connect a trusted device/emulator and review actions accordingly. ADB must be installed and the device authorized for debugging.

Android MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Android MCP Server config there under the "mcpServers" key and restart the client.

Is Android MCP Server safe to use with Claude Desktop?

Do I need a configuration file?

No. config.yaml is optional. If only one device is connected, the server auto-selects it. Create config.yaml (copied from config.yaml.example) and set device.name to a serial from 'adb devices' only when you have multiple devices and want a specific one.

How do I find my device serial?

Run 'adb devices' and use the value in the first column (for example 13b22d7f or emulator-5554) as device.name in config.yaml.

How do I configure it in Claude Desktop?

Add an entry under mcpServers with command set to your uv executable path and args set to ["--directory", "path/to/android-mcp-server", "run", "server.py"], replacing the paths with your uv path and the absolute path to the cloned repo.

View repo Full Android MCP Server page