PhoneMcp - Android Phone Control via ADB
@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
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.
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).
More Developer Tools MCP servers
Burp Suite MCP Server Extension
PortSwiggerMCP Server for Burp
Sentry
modelcontextprotocolModel Context Protocol Servers
Code Index MCP
johnhuang316A Model Context Protocol (MCP) server that helps large language models index, search, and analyze code repositories with minimal setup
test
cloudwegoThe ultimate LLM/AI application development framework in Go.
Golf
golf-mcpProduction-Ready MCP Server Framework • Build, deploy & scale secure AI agent infrastructure • Includes Auth, Observability, Debugger, Telemetry & Runtime • Run real-world MCPs powering AI Agents
Comments