mcpField
A
Android Mobile Mcp

Android Mobile Mcp

Local
github.com/erichung9060Developer Tools2Updated 55w ago
Repository

About Android Mobile Mcp

Android Mobile MCP connects the Model Context Protocol to Android device automation. It is for AI agents that need to inspect screens and operate devices through UI analysis, gestures, text input, navigation, app management, and screenshots.

Key features

  1. 01Extract UI hierarchy and element coordinates
  2. 02Capture screen images
  3. 03Perform clicks and swipes
  4. 04Enter text into focused fields
  5. 05Send system key presses
  6. 06List and launch apps

Use cases

  1. 01Inspect UI elements on an Android screen
  2. 02Automate taps and swipes in an app
  3. 03Fill and submit text in an app
  4. 04Launch an app or navigate system controls

MCP support

The MCP server exposes Android automation tools to clients, including UI inspection, touch actions, text entry, key presses, app management, and screenshots. A device must be connected via USB or network, with USB debugging enabled and ADB installed.

#android#mobile#mcp

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "Android-Mobile-MCP": {
      "command": "uvx",
      "args": [
        "android-mobile-mcp"
      ]
    }
  }
}
Run commanduvx android-mobile-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiandroid-mobile-mcp

Tools

9

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

Android Mobile MCP

Overview

Android Mobile MCP bridges the Model Context Protocol with Android device automation, enabling AI agents to interact with Android devices through UI manipulation, app management, and screen capture.

MCP Configuration

{
  "mcpServers": {
    "android-mobile-mcp": {
      "command": "uvx",
      "args": ["android-mobile-mcp"]
    }
  }
}
Prerequisites
  1. Connect Android device via USB or network
  2. Enable USB debugging on your Android device
  3. Install ADB (Android Debug Bridge)

Tools Reference

Screen Analysis

mobile_dump_ui - Extract UI elements as hierarchical JSON

  • Parses screen XML to identify focusable elements and text content
  • Calculates center coordinates for each interactive element
  • Returns structured parent-child element relationships

mobile_take_screenshot - Capture current screen state

  • Returns PNG image data for visual analysis
Touch Interactions

mobile_click - Click at specific coordinates

  • Validates coordinates against current UI state
  • Requires prior mobile_dump_ui call for coordinate verification
  • Prevents clicking on invalid or non-interactive areas

mobile_swipe - Perform swipe gestures

  • Executes directional swipes between two coordinate points
  • Configurable duration for gesture speed control
Text Input

mobile_type - Input text into focused fields

  • Sends text to currently active input field
  • Optional automatic submission with Enter key
Navigation

mobile_key_press - Press system buttons

  • Supports hardware and virtual keys: BACK, HOME, RECENT, ENTER
App Management

mobile_list_apps - List installed applications

  • Filters out system apps and non-launchable packages
  • Returns only user-accessible applications

mobile_launch_app - Start applications by package name

  • Validates package existence before launch attempt

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.