# iPhone Use

Connects an AI assistant to a physical iPhone from your Mac. It reads screen elements as structured text, clicks buttons, and types directly into apps lacking public APIs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 344
- Author: leeguooooo
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/leeguooooo/iphone-use
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/iphone-use

## What it does

A local Rust background service runs on your Mac, communicating with an XCTest runner on iOS. Rather than capturing raw pixels, the daemon parses accessibility hierarchies in roughly 0.1 s. Completed interactions can be recorded into repeatable sequences that execute later without LLM tokens.

The agent handles app launches by title, verifies element settlement before completing an action, and inputs text up to 20000 characters in one step. Your Mac pointer and windows stay untouched. The connection runs across USB or an encrypted Wi-Fi link.

Initial configuration fails unless the iPhone runs iOS 15 or newer with Developer Mode active and connects via USB to a Mac on macOS 15+. Xcode must be signed in with an Apple ID beforehand.

## Requirements
- Needs: a prebuilt binary from the repository releases

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- audit multi-step sign-in sequences on a physical iOS device
- read private interface text from apps lacking public developer APIs
- insert thousands of characters into mobile documents without manual typing
- automate mobile regression checks across native iOS views

## Example prompts
- Open Health and check the daily step count for this week
- Launch our staging build on the attached phone and report where the login sequence fails
- Export the full transaction list from the open banking screen

## Similar
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 9946
- [mobilerun](https://affpapa.org/en/nevibecode/mcp/mobilerun.md) — MCP server · ★ 9751
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11912
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6505
- [ShipSwift](https://affpapa.org/en/nevibecode/mcp/shipswift.md) — MCP server · ★ 3244
- [agent-device](https://affpapa.org/en/nevibecode/mcp/agent-device.md) — MCP server · ★ 5149

---
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