android-mcp-server

An MCP (Model Context Protocol) server that exposes Android Debug Bridge (ADB) to AI assistants. Control Android devices and emulators directly from Claude, Codex, GitHub Copilot, Gemini CLI, Cursor, or any MCP-compatible client.

• Features
• Requirements
• Setting up ADB
• Installation
• Tools
• Example usage
• Development
• License

• Screenshot — capture device screen with inline image display and auto-compression
• UI interaction — tap, swipe, find elements by text/ID, type text, press keys
• App management — install, uninstall, inspect app info and intent filters
• File transfer — push and pull files between host and device
• Streaming — capture logcat, top, and other long-running commands
• Multi-device — target specific devices by serial when multiple are connected
• Claude Desktop compatible — auto-detects ADB path, no PATH configuration needed

• Node.js 18+
• Android SDK Platform Tools (adb)
• A connected Android device or running emulator

See docs/adb-setup.md for installation instructions on macOS, Linux, and Windows.

Add to claude_desktop_config.json:

| Platform | Path | |----------|------| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json |

{
  "mcpServers": {
    "android": {
      "command": "npx",
      "args": ["-y", "@moallemi/android-mcp-server"]
    }
  }
}

claude mcp add android -- npx -y @moallemi/android-mcp-server

Or add manually to .mcp.json in your project root:

{
  "mcpServers