Android Mobile

🤖 This MCP server enabling AI agents to control Android devices.

python

4

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "erichung9060-android-mobile-mcp": {
      "command": "uvx",
      "args": [
        "android-mobile-mcp"
      ]
    }
  }
}

Android Mobile MCP connects the Model Context Protocol with Android device automation, letting you control UI actions, app management, and screen capture from AI agents.

How to use

You will run an MCP client that discovers and connects to the Android Mobile MCP server. Once connected, you can analyze the current screen to identify interactive elements, perform taps or swipes, type text into focused fields, navigate with system keys, and manage apps. Use the available tools to inspect UI structure, capture screenshots, and execute precise actions on the device.

Typical usage patterns include: first dump the UI to learn element positions, then target specific coordinates for taps or swipes. When you need to interact with text fields, focus the field and send the desired text. If you must return to a home screen or previous screen, issue key presses such as BACK or HOME. To launch or switch apps, list installed apps to find a launcherable package, then start it by package name.

How to install

Prerequisites you must have in place before starting the MCP server: connect your Android device via USB or over the network and enable USB debugging on the device. Install ADB (Android Debug Bridge) on your workstation.

Next, obtain and install the MCP runtime tool named uvx on your computer. This runtime is used to execute the Android Mobile MCP server component.

Configure the MCP server using the provided configuration snippet, then start the server with the runtime. The start command corresponds to the runtime together with the server’s identifier from the configuration.

{
  "mcpServers": {
    "android-mobile-mcp": {
      "command": "uvx",
      "args": ["android-mobile-mcp"]
    }
  }
}

Notes and setup details

Security considerations: ensure your device connection is secure and that your MCP runtime is sourced from a trusted origin. Only enable debugging on devices you control during development and test phases.

Available tools

mobile_dump_ui

Extracts UI elements as hierarchical JSON by parsing the current screen, identifying focusable elements and text, calculating center coordinates for interactions, and returning parent-child relationships.

mobile_take_screenshot

Captures the current screen and returns PNG image data for visual analysis.

mobile_click

Clicks at specified coordinates after validating against the current UI state and requires a prior mobile_dump_ui to verify coordinates.

mobile_swipe

Performs swipe gestures between two coordinates with configurable duration for gesture speed control.

mobile_type

Inputs text into the currently focused field and can optionally submit with Enter.

mobile_key_press

Sends system key events such as BACK, HOME, RECENT, and ENTER.

mobile_list_apps

Lists installed apps, filtering to user-accessible and launchable packages.

mobile_launch_app

Launches an application by package name after validating its existence.