@wilsonbeam/openclaw-adb-mcp

Give AI agents full control of real Android phones.

MCP Server + OpenClaw Skill for Android device automation via ADB.

What Can It Do?

• 📱 Screen Control — tap, swipe, type text, take screenshots

• 📞 Phone Functions — make calls, send SMS, check call state

• 📦 App Management — install, uninstall, list packages

• 🔧 Device Control — shell commands, push/pull files, wake screen

Quick Start

1. Install ADB

# macOS
brew install android-platform-tools

# Linux  
sudo apt install adb

# Windows
# Download from developer.android.com/tools/releases/platform-tools

2. Connect Your Android Device

1. Enable Developer Options on your phone

2. Enable USB Debugging

3. Connect via USB cable

4. Accept the authorization prompt on your phone

Verify:

adb devices
# Should show: XXXXX device

3. Add to OpenClaw

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

mcp:
  servers:
    adb:
      command: npx
      args: ["@wilsonbeam/openclaw-adb-mcp"]

Or install globally first:

npm install -g @wilsonbeam/openclaw-adb-mcp

Then:

mcp:
  servers:
    adb:
      command: openclaw-adb-mcp

4. Install the Skill (Optional but Recommended)

The skill teaches your AI agent how to use the ADB tools effectively.

# From clawhub.com (coming soon)
openclaw skill install adb

# Or manually copy the skill folder
cp -r skill/ ~/.openclaw/skills/adb/

Available Tools (26 total)

Core ADB

Screen Control

Phone Functions

Unlock

Auto-Unlock

The adb_unlock tool supports multiple lock types:

// Password
adb_unlock({ type: "password", credential: "mypassword" })

// PIN
adb_unlock({ type: "pin", credential: "1234" })

// Pattern (3x3 grid, digits 0-8)
// Grid layout:
//   0 1 2
//   3 4 5
//   6 7 8
adb_unlock({ type: "pattern", credential: "0123" })  // Top row
adb_unlock({ type: "pattern", credential: "0147" })  // L-shape
adb_unlock({ type: "pattern", credential: "02468" }) // X pattern

// Swipe only (no security)
adb_unlock({ type: "none" })

Example Conversations

"Take a screenshot of my phone" → Agent uses adb_screenshot, returns the image

"Call Mom at +1-555-123-4567" → Agent uses adb_make_call

"Open Chrome and search for weather" → Agent uses adb_start_activity to launch Chrome, adb_tap on search bar, adb_type_text to enter query

"Install the APK I just downloaded" → Agent uses adb_install_app with the APK path

Project Structure

openclaw-adb-mcp/
├── src/
│   ├── index.ts          # MCP server entry point
│   └── adb/
│       ├── executor.ts   # Low-level ADB execution
│       ├── core.ts       # Device, app, file operations
│       ├── screen.ts     # Tap, swipe, screenshot
│       └── phone.ts      # Call, SMS functions
├── skill/
│   ├── SKILL.md          # OpenClaw skill definition
│   └── scripts/
│       └── check-setup.sh
├── package.json
└── tsconfig.json

Multiple Devices

All tools accept optional deviceId. If omitted with multiple devices connected, ADB errors. Use adb_list_devices to get device IDs.

Development

git clone https://github.com/wilsonbeam/openclaw-adb-mcp
cd openclaw-adb-mcp
npm install
npm run build
npm run dev  # Build and run

Troubleshooting

No devices found

• Check USB cable and connection

• Enable USB debugging on device

• Run adb kill-server && adb start-server

Device unauthorized

• Accept the RSA key prompt on your phone screen

Screenshot fails

• Wake the screen first with adb_wake

• Some devices need screen unlock

License

MIT

Author

Wilson Beam / OpenClaw