PhoneMcp - Android Phone Control via ADB

Name: PhoneMcp - Android Phone Control via ADB
Author: kengerlwl

@kengerlwl

About PhoneMcp - Android Phone Control via ADB

Control your Android phone via ADB using AI assistants. Supports both zero-config Skill mode (CatPaw/Claude Code) and standard MCP server mode (Claude Desktop/Cursor). Features: screen capture, tap/swipe gestures, text input, app management, file transfer, shell commands, and mor

#android #adb #mobile #phone #automation

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "phoneMcp": {
      "command": "python",
      "args": [
        "main.py",
        "serve"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is PhoneMcp - Android Phone Control via ADB?

PhoneMcp is an AI phone control tool that allows AI assistants to directly see an Android phone’s screen, tap buttons, input text, and open apps via ADB. It provides two integration modes — Skill (zero-config) and MCP — and is designed for users who want to automate phone operations through natural language.

How to use PhoneMcp - Android Phone Control via ADB?

Enable USB debugging on the Android phone and connect it via USB or WiFi. For Skill mode, download the Skill archive from Releases and unzip it into the AI client’s Skill directory (e.g., ~/.catpaw/skills/phone-mcp/). For MCP mode, download the standalone executable and start the server with ./phone-mcp serve, then configure the MCP client with the SSE or STDIO transport. The tool automatically detects connected devices.

Key features of PhoneMcp - Android Phone Control via ADB

Screenshot capture of the phone screen
Touch operations: tap, double‑tap, swipe
Text input with full Chinese support
System key press (back, home, volume, power)
App launch, search, and current app retrieval
UI element recognition for precise tapping by index/text
OCR mode for WebView, games, and Flutter apps
Multi‑device support via USB and WiFi

Use cases of PhoneMcp - Android Phone Control via ADB

Open an app and send a message via natural language command
Take a screenshot to see the current phone interface
Open settings and toggle WiFi off
Search for a product on Taobao and tap the result
List all installed apps on the phone

FAQ from PhoneMcp - Android Phone Control via ADB

What’s the difference between Skill mode and MCP mode?

Skill mode requires no configuration — just unzip and place the folder in the AI client’s Skill directory. MCP mode requires starting a server and adding a configuration block in the MCP client (e.g., Claude Desktop, Cursor).

What are the system requirements?

Python 3.10+ and an Android device with USB debugging enabled. The standalone executables embed ADB, so no separate ADB installation is needed.

How do I connect the phone?

Connect via USB (preferred) or WiFi. The server automatically detects devices. First enable USB debugging on the phone and accept the authorization prompt.