Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

iphone-cli (iph)

by HyunSeobversion 0.1.8i★ 109iRuns on your computerOfficial site ↗
Registry nameio.github.HyunSeob/iphone-cli

How to install

What it does

Control any app on a real iPhone (iOS 27+) via accessibility tree. No Xcode or WebDriverAgent.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Developer tools

Use together with

Skills that teach the AI this kind of work; they work alongside this one

rea

Reverse engineer anything with agents, from app behavior down to native binaries.

by morluto★ 468,7331 skills

Skill · How-to guide

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

by multica-ai★ 234,3321 skills

Skill · How-to guideNo license stated

graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

by Graphify-Labs★ 150,2871 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity24/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score36/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Claude cannot connect iphone-cli (iph) yet

The maker has not listed install details in the MCP Registry yet

ChatGPT cannot connect iphone-cli (iph) yet

The maker has not listed install details in the MCP Registry yet

What you can do instead

B · Others in Developer tools that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect iphone-cli (iph) yet

The maker has not listed install details in the MCP Registry yet

Cursor cannot connect iphone-cli (iph) yet

The maker has not listed install details in the MCP Registry yet

VS Code cannot connect iphone-cli (iph) yet

The maker has not listed install details in the MCP Registry yet

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use iphone-cli (iph)💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
0.1.8
Published to registryi
Nov 19, 2026
Code last changedi
Nov 19, 2026
Maker
HyunSeob
Packages
cargo: iphone-cli
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account HyunSeob, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed today

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/hyunseob-iphone-cli.svg)](https://mcp.popnx.com/en/servers/hyunseob-iphone-cli)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Developer toolsi

  • More stars than 97% of the other 6182 servers in this category
  • Published to the registry more recently than 99% of the other 6182 servers in this category
  • Basic checks equal to or better than 99% of the other 6182 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is iphone-cli (iph) safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed today, and the latest version (0.1.8) reached the registry today.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Rust on your computer.

What can I use instead?

In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

by ahmedkhaleel2004Widely used★ 19KUpdated 2 months ago

Runs in the cloud✓ service owner · gitdiagram.comTried by the PopNx team

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

by AppllamaWidely used★ 5.2KUpdated 3 months ago

Runs in the cloud✓ service owner · appllama.io

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

by repowise-devWidely used↓ 6.5K/wk★ 8.2K Stars for the whole repoUpdated 6 days ago

Computer or cloud✓ service owner · repowise.dev
Compared with similar ones
This one
iphone-cli (iph)
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoYesNoNo
Basic checks3/34/44/44/44/45/5
LicenseMITMITMITApache-2.0Apache-2.0AGPL-3.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

iphone-cli (iph)

Let AI agents read and operate any app on a real iPhone — straight from your terminal.

No Xcode. No WebDriverAgent. No app installed on the phone. 100% Rust.

  • Direct Apple developer services — connects over USB or Wi-Fi to the same accessibility and HID services Xcode uses, with no signing or test runner
  • Accessibility tree, not screenshots — reads structured UI elements cleanly, and runs multi-step flows in one call with a built-in QuickJS engine (iph script)
  • Agent-ready — CLI + MCP server (iph mcp) + safety-first outcomes (done / not_sent / unknown)
  • Single native binary (macOS & Windows) — no Python, Node.js, or Appium runtime; install one binary and target a real iPhone on iOS 27+

Website · llms.txt · crates.io · 한국어

Built on the principle of Poki (a new implementation from its documented behaviour and device experiments, with no Poki code). Device communication relies on idevice (MIT).

$ iph read --human

Settings 430x932 15 elements application "Settings" @0,0 430x932 header "Settings" @20,119.3 53.7x37 switch "Airplane Mode" = "0" @20,489.3 390x49.3 button "Wi-Fi, HomeNet" @20,538.7 390x49.3 button "General" @20,700 390x49.3 …

$ iph tap "General" {"ok":true,"outcome":"done","elapsed_ms":1752,"sent":true,"verified":true,"screen_changed":true,…}

Scope

HostmacOS, Windows 10/11 (x64)
DeviceA real iPhone, iOS 27 or later (verified on one iPhone 15 Pro Max with iOS 27.0.1 only, Korean interface). Touch and text input go through the phone's screen-sharing service (com.apple.coredevice.displayservice, new in iOS 27), so input is not expected to work on iOS 26 or earlier (not tried)
ConnectionUSB or the same LAN (the computer may use Ethernet; verified over USB and Wi-Fi on Windows)
Out of scopeSimulators, Android, Linux hosts, landscape

On Windows, doctor, reading, touch and scripts were checked with one iPhone19,4 on iOS 27.2 over USB.

Comparison with alternatives

Capabilityiphone-cli (iph)iPhone Mirroring + OCR toolsAppium / WebDriverAgentmobile-mcp
Native Accessibility TreeYes (structured JSON)No (screenshots / Vision OCR)YesPartial (WDA on real iOS)
No Xcode / No code signingYesYesNo (requires Xcode & signing)No (WDA signing on real iOS)
No app installed on iPhoneYesYesNo (installs WDA runner)No (installs WDA on real iOS)
Windows host supportYes (macOS & Windows)No (macOS 15+ only)Limited (needs macOS to build WDA)Limited on real iOS
Works in the EUYes (no Mirroring needed)No (Mirroring unavailable)YesYes
Unicode / clipboard text inputYes (paste + restore)Simulated keystrokesYesVaries
Built-in multi-step scriptingYes (embedded QuickJS)External / per-turn callsExternal SDKPer-turn MCP calls
Safety outcome contract`done` / `not_sent` / `unknown`VariesStandard exceptionsStandard tool errors
Target scopeReal iPhone, iOS 27+Real iPhone, iOS 18+ (macOS 15+)Real iOS & SimulatorsSimulators, Android, WDA iOS
  • Choose `iphone-cli` (`iph`) when you want Claude Code, Codex, or another AI agent to operate a real iPhone (iOS 27+) via the accessibility tree without Xcode or WebDriverAgent — including on Windows or in the EU.
  • Choose an iPhone Mirroring + OCR tool if your phone runs iOS 18–26 on macOS 15+ outside the EU.
  • Choose Appium / WebDriverAgent or `mobile-mcp` if you need iOS Simulators, Android, or iOS 26 and earlier with an element tree.

Install

Neither Rust nor Xcode is needed. On a Mac it is one line in Terminal (it uses only tools macOS ships: curl, tar, shasum).

curl -fsSL https://raw.githubusercontent.com/HyunSeob/iphone-cli/main/install.sh | sh

iph setup # walks through what the phone needs

It downloads the universal binary (Apple silicon and Intel) from the latest release, checks its checksum and puts it at ~/.local/bin/iph. IPH_INSTALL_DIR picks another folder and IPH_VERSION=v0.1.0 a specific version. On Windows, download iph-windows-x86_64.zip from the releases and put iph.exe in a folder on your PATH.

  • Mac: plug the phone in and tap Trust on it; that pairs it.
  • Windows: Apple's device service must be installed: the Apple Devices app from the Microsoft Store, or just the service with winget install Apple.AppleMobileDeviceSupport. Then plug the phone in and tap Trust.
  • Developer disk image: when the phone lacks it, iph doctor installs it. It uses Xcode's copy when the Mac has one, and otherwise fetches one once from the public doronz88/DeveloperDiskImage repository (about 18 MB, pinned commit and SHA-256). The iph repository contains no Apple files.

With Rust 1.88 or later, the crate on crates.io installs the same iph (building it takes a few minutes; on Windows it needs Visual Studio Build Tools (C++)):

cargo install iphone-cli      # ~/.cargo/bin/iph

Or from a checkout:

git clone https://github.com/HyunSeob/iphone-cli

cd iphone-cli cargo install --path . # ~/.cargo/bin/iph

First-time setup

iph setup runs iph doctor, says in one line what to do on the phone for each failed check, and checks again. An agent can read checks[].user_action from iph doctor (JSON) and guide the user.

CheckRequiredWhat it is
pairingyesThe Mac holds a pairing record for the phone. If not: connect by USB and tap Trust
connectionyesThe phone is visible over USB or the same Wi-Fi
developer_modeyesSettings → Privacy & Security → Developer Mode. If it is off, iph doctor makes that switch appear
developer_disk_imageyesSource of the accessibility, display and input services. When missing, iph doctor fetches and installs it (see Install)
screen_unlockedyesThe phone is unlocked. Only lockdown's word decides a lock
settings_in_frontyesSettings comes to the front (fails when something covers it). When the screen cannot be read, accessibility_tree fails instead
accessibility_treeyesScreen elements can really be read
touch_inputyesScrolls the Settings list down one step and back to see that touch lands (--no-touch-test skips it)
wifirecommendedWireless lockdown flags and the phone's usbmuxd Network entry (see below)
auto_lockrecommendedAuto-Lock → Never for long sessions
do_not_disturbinfoShown only while Do Not Disturb from iph dnd on is still on

Setup requirements and how to interpret the checks are in docs/onboarding.md (Korean).

Wi-Fi setup and troubleshooting

Pair by USB first, then keep the iPhone unlocked on the same LAN. The computer may use Ethernet. To enable wireless connections, run this while USB is attached:

iph doctor --fix-wifi

If the phone is still not discovered, register its IP below. Wireless setup details (Korean).

Notification banners take taps near the top of the screen. Banners cover the top of the screen and are not part of the accessibility tree. A tap near the top then lands on the banner and opens another app (this happened once during development). For long unattended work turn Do Not Disturb on with iph dnd on, and put it back with iph dnd off afterwards. Details: Do Not Disturb below.

Direct IP when automatic discovery fails

For a USB-trusted phone missing from discovery, use the IP shown in Settings → Wi-Fi → the network's info button:

iph devices                                      # while USB is attached: note the UDID

iph --udid connect --ip # after unplugging USB iph --udid read

The Apple device service is still required. CLI, MCP and scripts share the saved address for the selected UDID; register it again if the IP changes. Connection details (Korean).

Commands

Every command prints JSON; add --human for people. The device is chosen by --udid, then IPH_UDID, then udid in ~/.config/iph/config.toml, then the only connected phone. With several phones and none chosen, you get an error with the list.

CommandDoes
iph connect --ip Verify and save the selected paired phone's IP
iph devicesConnected phones, iOS version, connection, readiness
iph setup / iph doctorPreparation and checks
iph read [--app] [--all] [--full] [--raw] [--max-age ms]Elements on screen. --all includes off-screen ones, --full adds identifiers (about 0.5 s more), --raw attaches every numbered attribute
iph find Elements matching a selector
iph tap [--long ms] [--double]Tap the middle of an element, or a point
iph swipe [--duration ms] [--drag]Swipe. --drag slows to a stop before lifting, so nothing coasts
`iph pinch [in\out] [--scale F] [--rotate DEG] [--at selector \x,y] [--duration ms]`Two fingers. out spreads them (zoom in, scale 2), in pinches them (zoom out, scale 0.5); --scale takes 0.25 to 4, --rotate degrees (clockwise is positive). They meet in the middle of the screen or at --at. screen_changed: false is a fair answer on a screen that does not zoom
iph scroll [--until selector] [--max N]One step, or until an element shows
iph type [--clear] [--submit]Paste text into the field that has the keyboard (any language, emoji). The clipboard is put back and the field's value checked
iph key return, esc, tab, cmd+a …
iph button Hardware buttons
iph launch [--restart] [--env K=V]… [-- …] / iph appsLaunch an app, list apps. --env sets environment variables and what follows -- goes to the app as launch arguments (iph launch com.example.app --env TZ=UTC -- -AppleLanguages "(ko)"). Either one restarts a running app, since only a new process takes them; the result says restart_implied, with the arguments and the variable names (never their values)
iph screenshot [-o file]PNG capture
iph batch A JSON array of steps in one call
iph script [--arg k=v]Run JavaScript as given (- reads stdin)
iph run [--arg k=v] / iph scriptsRun a saved script, list saved scripts
iph mcp [--tools a,b]MCP server on stdio
iph dnd Turn Do Not Disturb on, put the earlier Focus back, or show the current state
iph syslog [--app app] [--process name] [--pid N] [--level L] [--after SEQ] [--grep RE] [--max N] [-o file]Capture the phone's log in memory while other commands run; read returns what is new without stopping it, stop can return the latest matching entries. See Phone log
iph stopStop the resident process for this phone
Selectors
  • A plain string is an exact label: iph tap "General"
  • label="exact", label~="contains", label/regex/
  • role=button (application, button, switch, text_field, search_field, key, tab, header, text, image, link, adjustable, other)
  • id=… matches the accessibi

Only the beginning is shown; read the rest in the repo