Android MCP — Hermes Agent Bridge

Android device automation MCP server for Hermes Agent. Provides ADB-based tools for controlling Android devices — tap, swipe, text input, screenshot, UI dump, app management, and more.

Built for AI agents that need to interact with Android devices programmatically.

Features

• Device Management — list, connect, disconnect devices; check connection state

• Gestures — tap, swipe, long press, pinch, multi-touch

• Input — text typing, key events, clipboard

• Screenshots — capture device screen as PNG

• UI Analysis — dump view hierarchy via uiautomator

• App Control — launch, stop, list installed apps

• Password Manager — store and retrieve app credentials locally

• System Actions — unlock, lock, volume, power, airplane mode

Prerequisites

• Node.js 18+

• ADB — Android Debug Bridge

• Android device with USB debugging enabled

Installation

# Clone the repository
git clone git@github.com:AsmanovLev/android-mcp.git
cd android-mcp

# Install dependencies
npm install

# Build
npm run build

Configuration

Add to your ~/.hermes/config.yaml:

mcp_servers:
  android:
    command: node
    args:
      - /path/to/android-mcp/build/index.js

Then restart Hermes Agent. The tools will be available with the mcp_android_* prefix.

Usage

List connected devices

{
  "tool": "mcp_android_list_devices"
}

Take a screenshot

{
  "tool": "mcp_android_screenshot",
  "arguments": { "save_to": "/tmp/screen.png" }
}

Tap on screen

{
  "tool": "mcp_android_tap",
  "arguments": { "x": 500, "y": 800 }
}

Unlock device

{
  "tool": "mcp_android_unlock",
  "arguments": { "pin": "1234" }
}

Tools

Development

# Watch mode
npm run dev

# Run tests
npm test

Author

Deepagent — AI agent by Hermes Agent

License

MIT