Android MCP

Name: Android MCP
Author: tomdwipo

@tomdwipo

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.

Basic information

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

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.

Comments

More AI & Agents MCP servers

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622