MCP.so
Sign In
A

Android MCP

@tomdwipo

Repository

About Android MCP

A lightweight MCP server for Android operating system automation. This server provides tools to interact directly with Android devices, enabling automated testing, app interaction, and device control.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "android-mcp": {
      "type": "stdio",
      "command": "bash",
      "args": [
        "-c",
        "cd /path/to/agent/mcp/android && source .venv/bin/activate && uv run main.py --emulator"
      ],
      "alwaysAllow": [
        "State-Tool",
        "Click-Tool",
        "Type-Tool",
        "Swipe-Tool"
      ]
    }
  }
}

Tools

9

Click on specific coordinates

Get device state with optional screenshot

Long press on coordinates

Swipe between coordinates

Type text at coordinates

Drag and drop between coordinates

Press hardware buttons

Access notification panel

Wait for specified duration

Overview

What is Android MCP?

Android MCP is a lightweight MCP server for Android operating system automation. It provides tools to interact directly with Android devices, enabling automated testing, app interaction, and device control.

How to use Android MCP?

Install Python 3.13+, uv package manager, and set up the project with uv sync. Connect an Android device with USB debugging enabled, or use an emulator with the --emulator flag. Run the server via uv run main.py or configure it in MCP client settings such as Claude Desktop.

Key features of Android MCP

  • Click, long click, swipe, drag, and type on Android devices.
  • Get device state with optional visual screenshots.
  • Press hardware buttons and access notifications.
  • Wait functionality for timing control.
  • Works with both physical devices and Android emulators.

Use cases of Android MCP

  • Automated app testing and UI interaction.
  • Remote device control and scripting.
  • Repetitive task automation on Android devices.
  • Integration with AI assistants for device manipulation.

FAQ from Android MCP

What dependencies are required?

Python 3.13 or higher, uv package manager, ADB (Android Debug Bridge), and an Android device or emulator with USB debugging enabled.

How do I connect a physical device?

Enable Developer Options and USB debugging on the Android device, then connect via USB and verify with adb devices. Run uv run main.py (without the --emulator flag).

How do I use the server with an emulator?

Start the emulator, verify connection with adb connect emulator-5554, then run uv run main.py --emulator.

What tools are available?

Click, State, Long-Click, Swipe, Type, Drag, Press, Notification, and Wait tools. See the README for exact parameters.

How do I resolve “device not found” issues?

Ensure USB debugging is enabled, check adb devices output, try different cables/ports, or restart ADB with adb kill-server && adb start-server.

Frequently asked questions

What dependencies are required?

Python 3.13 or higher, uv package manager, ADB (Android Debug Bridge), and an Android device or emulator with USB debugging enabled.

How do I connect a physical device?

Enable Developer Options and USB debugging on the Android device, then connect via USB and verify with `adb devices`. Run `uv run main.py` (without the `--emulator` flag).

How do I use the server with an emulator?

Start the emulator, verify connection with `adb connect emulator-5554`, then run `uv run main.py --emulator`.

What tools are available?

Click, State, Long-Click, Swipe, Type, Drag, Press, Notification, and Wait tools. See the README for exact parameters.

How do I resolve “device not found” issues?

Ensure USB debugging is enabled, check `adb devices` output, try different cables/ports, or restart ADB with `adb kill-server && adb start-server`.

Comments

Basic information

Category

AI & Agents

Transports

stdio

Author

tomdwipo

Submitted by

Tom

More AI & Agents MCP servers

q-ring

I4cTime

Quantum-inspired keyring for AI coding agents. Secure secrets with superposition, entanglement, tunneling, and teleportation — CLI + 44 MCP tools.

3

1Panel

1Panel-dev

🔥 1Panel is a modern, open-source VPS control panel — and the only one with native AI agent support. Run Ollama models, deploy OpenClaw agents, and manage your entire server stack from one clean web interface.

36.1K

🔎 GPT Researcher

assafelovic

An autonomous agent that conducts deep research on any data using any LLM providers

28.1K

Just Domain.

Just.

Just Domain is the domain registrar for businesses built with AI. An AI assistant checks availability and both prices, first year and renewal, and hands back a checkout link for justdomain.ai. Read only by design: no pur

Transform MCP

Unstructured

The Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD