# phonedriver

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 342 repo stars
- Author: hridaya423
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hridaya423/phonedriver
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/phonedriver

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add phonedriver -- npx -y phonedriver
```

### Codex

**Platform CLI**
```bash
codex mcp add phonedriver -- npx -y phonedriver
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "phonedriver": {
            "command": "npx",
            "args": [
                "-y",
                "phonedriver"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "phonedriver": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "phonedriver"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add phonedriver npx -y phonedriver
```

## When to use it
- 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
- 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.

## Similar
- [appium-skill](https://affpapa.org/en/nevibecode/skills/appium-skill.md) — skill · 445 installs
- [Limrun](https://affpapa.org/en/nevibecode/mcp/limrun.md) — MCP server
- [argent-settings-permissions](https://affpapa.org/en/nevibecode/skills/argent-settings-permissions.md) — skill · 25300 installs
- [ascript-mcp](https://affpapa.org/en/nevibecode/mcp/ascript-mcp.md) — MCP server · ★ 11 repo stars
- [argent-ios-device-interact](https://affpapa.org/en/nevibecode/skills/argent-ios-device-interact.md) — skill · 17100 installs

From the same set: [hridaya423/phonedriver](https://affpapa.org/en/nevibecode/by/hridaya423/phonedriver.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
