Android MCP Tools

A small local MCP server that exposes a safe, explicit subset of Android Debug Bridge automation to AI agents and test runners.

Tools

• list connected devices;
• tap and swipe by coordinates;
• type into the focused field;
• send HOME, BACK, ENTER and APP_SWITCH keys;
• launch an installed package;
• dump the current UI Automator accessibility hierarchy.

ADB stays local. The server does not publish a device or open a network listener; it communicates through MCP stdio.

Requirements

• Node.js 20+
• Android platform tools (adb)
• USB debugging or a trusted Wi-Fi ADB connection

Run

npm install
npm test
npx android-mcp-tools

Example MCP configuration:

{
  "mcpServers": {
    "android": {
      "command": "npx",
      "args": ["android-mcp-tools"]
    }
  }
}

Set ADB_BIN when adb is not available through PATH.

Safety

Only devices already trusted by the local ADB installation are accessible. The project contains no device serials, credentials, sessions, screenshots or user data.

Author

Denis Luzyanin — github.com/IMP4R