Android MCP

🚀 Android MCP

Android-MCP is a lightweight, open-source bridge between AI agents and Android devices. It runs as an MCP server, enabling large-language-model agents to perform real-world tasks such as app navigation, UI interaction, and automated QA testing without relying on traditional computer-vision pipelines or preprogrammed scripts.

https://github.com/user-attachments/assets/cf9a5e4e-b69f-46d4-8487-0f61a7a86d67

🚀 Quick Start

Android-MCP serves as a bridge between AI agents and Android devices. It allows large - language - model agents to execute various tasks on Android devices without the need for traditional computer - vision pipelines or preprogrammed scripts.

✨ Features

• Native Android Integration
  Interact with UI elements via ADB and the Android Accessibility API, including launching apps, tapping, swiping, inputting text, and reading view hierarchies.

• Bring Your Own LLM/VLM
  It is compatible with any language model, eliminating the need for a fine - tuned CV model or OCR pipeline.

• Rich Toolset for Mobile Automation
  Comes with pre - built tools for gestures, keystrokes, capture, device state, and shell command execution.

• Real - Time Interaction
  The typical latency between actions (e.g., two taps) ranges from 2 - 4s, depending on device specifications and load.

Supported Operating Systems

• Android 10+

📦 Installation

Prerequisites

• Python 3.10+
• UIautomator2
• Android Emulator/ Android Device

Getting Started

1. Clone the repository

git clone https://github.com/CursorTouch/Android-MCP.git
cd Android-MCP

2. Install dependencies

uv python install 3.10
uv sync

3. Connect to the MCP server
   1. Locate your Claude Desktop configuration file:
      • Windows: %APPDATA%\Claude\claude_desktop_config.json
      • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   2. Add the following JSON to your Claude Desktop config:

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

Replace:

• path/to/uv with the actual path to your uv executable
• path/to/Android-MCP with the absolute path to where you have cloned this repo

NOTE: --emulator is used to run in an emulator. Remove it to use an actual device.

3. Restart the Claude Desktop Open your Claude Desktop, and “android - mcp” should now appear as an integration.

For troubleshooting tips (log locations, common ADB issues), see the MCP docs.

🛠️ MCP Tools

Claude can access the following tools to interact with Windows:

• State - Tool: To understand the state of the device.
• Click - Tool: Click on the screen at the given coordinates.
• Long - Click - Tool: Perform a long click on the screen at the given coordinates.
• Type - Tool: Type text on the specified coordinates (optionally clears existing text).
• Swipe - Tool: Perform a swipe from one location to another.
• Drag - Tool: Drag from one point to another.
• Press - Tool: To press the keys on the mobile device (Back, Volume Up, ...etc).
• Wait - Tool: Pause for a defined duration.
• State - Tool: Combined snapshot of active apps and interactive UI elements.
• Notification - Tool: To access the notifications seen on the device.
• Shell - Tool: To execute shell commands on the android device.

⚠️ Important Note

⚠️ Important Note

Android-MCP can execute arbitrary UI actions on your mobile device. Use it in controlled environments (emulators, test devices) when running untrusted prompts or agents.

📄 License

This project is licensed under the MIT License. See LICENSE for details.

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING for dev setup and PR guidelines.

Made with ❤️ by Jeomon George

Citation

@misc{
  author       = {Jeomon George},
  title        = {Android-MCP},
  year         = {2025},
  publisher    = {GitHub},
  howpublished = {\url{https://github.com/CursorTouch/Android-MCP}},
  note         = {Lightweight open-source bridge between LLM agents and Android},
}