Poki: an MCP server that lets agents use a real iPhone
Plug an iPhone into a Mac and Claude Code reads its screen and taps through apps, no jailbreak
- Who
- Made by Joseph Zhou (JosssphZhou) with co-creator ZhehanZhang, for anyone who wants an agent to do the work inside iPhone apps.
- When
- The repository opened on November 5, 2026. The iPhone app's Alpha 0.2.9 came out November 8, a Pre-alpha build November 9.
- Where
- The MCP server runs on a Mac (macOS 15+) and plugs into Claude Code, Codex and other MCP clients. Linux and Windows have community ports.
What was hard
Checking a booking, comparing insurance terms in an app, replying in a messenger: work that lives inside iPhone apps has no API. An agent can do it all on the computer, and the moment it moves to the phone you are tapping through screens yourself.
What it does about it
Poki turns a real iPhone connected to a Mac into a tool the agent can use. The agent gets the buttons and text on screen as a list, picks what to touch, and Poki sends the touch or keystrokes there, then reads the screen again to see what happened. It uses Apple's developer connection with no jailbreak or extra hardware, and while it types, Poki's own typing panel shows with a Take Over button so you can step in.

What people made with it
Connected a real iPhone over Tailscale and had Poki check insurance terms in WeChat and Alipay. WeChat product details came through; Alipay results did not load reliably, and the report lists fixes.
在微信微保中打开产品入口,确认已有长期医疗险入口,并查看成人重疾险的保额档位、重疾/中症/轻症和二次赔入口。
Had no Mac, so ported Poki to Linux and verified taps, typing, swipes and screenshots on a real iPhone over USB, LAN and Tailscale. The README now points to the port.
I don't have a Mac, so I ported it to Linux and thought you might want to know it works end to end.
How it runs inside
- 1
You → Claude Code · Codex
"Search esp32 in Chrome and summarize"The agent reads the poki-mcp skill for how to type into fields and answer system prompts on a real phone.skills/poki-mcp/SKILL.md - 2
Claude Code · Codex → src/stdio.mjs
tools/call: list_elements, tap, fillThe stdio process registered with claude mcp add receives each tool call.src/stdio.mjs - 3
src/stdio.mjs → Poki daemon (127.0.0.1:47825)
/mcp with a bearer token and sessionThe loopback-only daemon queues device work and asks for approval before sensitive actions.src/daemon.mjs - 4
Poki daemon (127.0.0.1:47825) → poki-native (Rust)
{"op": "ax_tree"} to read the screenIt reads the accessibility tree and the foreground app, so the agent can pick what to touch next.native/bridge/src/ax.rs - 5
poki-native (Rust) → Your iPhone's screen
tap · drag · type_keys as HID reportsTouches and key presses go out at a person's pace; whether they worked is checked by reading the screen again.native/bridge/src/gesture.rs
What goes in, what comes out
Is it for you
Good for
- Handing an agent repetitive work that only exists inside phone apps
- Driving an iPhone from your Claude Code or Codex subscription, no extra model account
- Running simulator or device screen checks while building an iOS app
- Asking for phone tasks from Telegram or iMessage
Not for
- It controls your real iPhone: ask it to send messages or pay and it will. Screen contents go to your configured model service.
- Physical devices are verified only with the Chinese interface, portrait only; iOS 18 to 26 was not tested on hardware this release.
- Signing with a free Apple Account lasts 7 days and needs renewal.
- AGPL-3.0-only: companies may use it, but offering a modified Poki as a network service means publishing those changes.
Reviewed by Devalley’s editor before publishing. How the column is made