phonedriver — Claude Code MCP server for phone control
The phonedriver MCP server for Claude Code lets an agent inspect and operate an Android phone or iPhone. It can run app checks and phone tasks, pausing for approval before a payment tap.
AGPL-3.0 ★ 342 updated 2026-11-16
claude mcp add phonedriver -- npx -y phonedriverWhat phonedriver does
phonedriver sends the phone screen to an agent as text and lets it interact with the device. It asks for human approval before tapping a payment button. The server communicates with MCP clients over stdio.
Run an Android emulator, connect an Android phone with USB debugging enabled, or start the iOS Simulator. On first use, phonedriver downloads and caches a binary for the host system. Run phonedriver doctor to check adb, Xcode, and connected devices.
What it helps with
- test a mobile app sign-up and record steps for bugs
- inspect onboarding screens in dark and light modes
- change phone settings through on-screen actions
- pause a payment action for human approval
Example prompts for the agent
- Test the app sign-up and write reproduction steps for each bug you find.
- Review onboarding in dark and light modes and identify screens with hard-to-read text.
- Change Chrome's search engine in the phone settings.
How to install phonedriver
Platform CLI
claude mcp add phonedriver -- npx -y phonedriverPlatform CLI
codex mcp add phonedriver -- npx -y phonedriverConfig file
{
"mcpServers": {
"phonedriver": {
"command": "npx",
"args": [
"-y",
"phonedriver"
]
}
}
}Config file
{
"servers": {
"phonedriver": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"phonedriver"
]
}
}
}Platform CLI
gemini mcp add phonedriver npx -y phonedriverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about phonedriver
How do I install phonedriver in Claude Code?
Run claude mcp add phonedriver -- npx -y phonedriver. Start an Android emulator, connect an Android phone with USB debugging enabled, or boot the iOS Simulator.
What does phonedriver do?
It gives an MCP agent access to an Android phone or iPhone screen and allows it to operate the device. The server requests approval before a payment tap.
What does phonedriver need to run?
Use a running Android emulator, an Android phone with USB debugging enabled, or the iOS Simulator. On first run, it downloads a binary for the host system.