PhoneMcp - Android Phone Control via ADB
@kengerlwl
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
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.
Does it support multiple devices?
Yes, it can list, connect, and manage multiple Android devices simultaneously.
Which transports are available for MCP mode?
SSE (default, listens on http://0.0.0.0:8009/Phone/sse) and STDIO (for clients that invoke the executable directly).
