🤖 Android MCP

Android-MCP is a lightweight, open-source tool that bridge between AI agents and Android devices. Running as an MCP server, it lets LLM agents perform real-world tasks such as app navigation, UI interaction and automated QA testing without relying on traditional computer-vision pipelines or preprogramed scripts.

Demo.mov

✨ Features

• Native Android Integration
  Interact with UI elements via ADB and the Android Accessibility API: launch apps, tap, swipe, input text, and read view hierarchies.

• Bring Your Own LLM/VLM
  Works with any language model, no fine-tuned CV model or OCR pipeline required.

• Rich Toolset for Mobile Automation
  Pre-built tools for gestures, keystrokes, capture, device state, shell commands execution.

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

Supported Operating Systems

• Android 10+

Installation

📦 Prerequisites

• Python 3.10+
• UIautomator2
• Android 10+ (Emulator/ Android Device)
• A computer to run MCP server

🏁 Getting Started

You can run the Android MCP server using UVX (recommended) or UV (for local development).

Option 1: UVX (Recommended)

No need to install dependencies manually. Just configure Claude Desktop:

1. Locate your config file

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the configuration

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

   Note: Remove --emulator if providing a physical device.

Option 2: UV Mode (Local Development)

1. Clone and Install

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

2. Configure Claude Desktop

   {
     "mcpServers": {
       "android-mcp": {
         "command": "uv",
         "args": [
           "--directory",
           "</PATH/TO/Android-MCP>",
           "run",
           "android-mcp",
           "--emulator"
         ]
       }
     }
   }

   Note: Replace </PATH/TO/Android-MCP> with the full path to your cloned directory.

3. Restart the Claude Desktop

Restart your Claude Desktop. You should see "android-mcp" listed as an available integration. That's it, now you're ready to start controlling your Android device with natural language.

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

---

🛠️ Available 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 long click on the screen at the given coordinates.
• Type-Tool: Type text on the specified coordinates (optionally clears existing text).
• Swipe-Tool: Perform swipe from one location to other.
• 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.

⚠️ Caution

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 CursorTouch,

developers: Jeomon George, Muhammad Yaseen

Citation

@misc{
  author       = {cursortouch},
  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},
}