Free guide · Sep 19, 2026

Run a virtual iPhone your AI agent can control

Check your Mac, boot the virtual iPhone, connect Claude and run a first test. Read the safety notes first.

The short version

vphone-cli boots an iPhone operating system in a virtual machine on an Apple Silicon Mac. The separate vphone-mcp adapter exposes its screen and controls to Claude. I would start with a simple Settings navigation test, then move to an app I own.

I checked the project's documentation and source code for this guide. I have not reproduced the full setup on a Mac. The developer's image below shows their virtual iPhone, not my own test.

What's in the full guide

  1. 011. Check your Mac before downloading anything
  2. 022. Understand the security step
  3. 033. Install and boot the virtual iPhone
  4. 044. Connect Claude Desktop
  5. 055. Run a small first test
  6. 06If something fails
  7. 07Sources and next steps