phonedriver

MCP server and CLI that lets AI agents (Claude Code, Codex, Cursor) see and control Android phones and iPhones. Reads the screen as text. Asks before it pays.

What is phonedriver?

MCP server and CLI that lets AI agents (Claude Code, Codex, Cursor) see and control Android phones and iPhones. Reads the screen as text. Asks before it pays.

Overview of phonedriver

What it is

phonedriver is an MCP server and CLI that allows AI agents (Claude Code, Codex, Cursor) to see and control Android phones and iPhones. It reads the screen as text and asks for confirmation before performing payment actions. It is licensed under AGPL-3.0 and is open source.

Key features

  • Reads the screen as a short numbered list of interactive elements (buttons, switches, groups) for the AI agent to act on.
  • Taps elements by their number and reports only what changed after the screen settles, without polling.
  • Uses a Java helper on Android (via adb) and an XCTest runner on iOS to read the accessibility tree and stream screen changes.
  • Claims 6.9x fewer tokens than mobile-mcp on a set of nine phone jobs (self-reported benchmark).
  • Can save and replay agent sessions as repeatable tests, with support for secrets and variables.
  • Records MP4 video of the screen on Android and iOS Simulator.

Use cases

  • Testing signup forms with invalid inputs and reporting bugs with steps to reproduce.
  • Changing settings buried multiple screens deep.
  • Finding the step where an app stops working.
  • Ordering food or performing other multi-step phone tasks, with payment confirmation required.

Getting started

shnpx -y phonedriver initThis adds phonedriver to agents found on your machine (Claude Code, Codex, Cursor, VS Code, Gemini CLI) and checks adb, Xcode, and devices. For plugin installation or manual MCP setup, see the repository README.

License and pricing

Licensed under AGPL-3.0. The project is open source with no stated pricing.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/hridaya423phonedriver.svg)](https://yunodb.com/tools/hridaya423phonedriver?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/hridaya423phonedriver?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/hridaya423phonedriver.svg" alt="Featured on YunoDB" height="20"></a>