ZeptapZeptap documentation
Mirror a real iPhone on your Mac and let AI agents tap, type and read its screen through a local MCP server.
Zeptap is a macOS app that turns a real iPhone into something an AI agent can use. The Mac sees the iPhone's screen over USB and touches and types on it as a Bluetooth keyboard and pointer. Chat with it from Zeptap's own chat panel, using your Claude or ChatGPT subscription or an OpenRouter API key, or let agents such as Claude Code, Claude Desktop, Codex and Cursor drive it through a local MCP server:
http://127.0.0.1:47801/mcpThe server speaks Streamable HTTP, listens on loopback only, and needs no API key. It exists while the Zeptap app is running on the same Mac. Nothing is installed on the iPhone, and nothing leaves the Mac.
Choose the shortest path
| Goal | Start here |
|---|---|
| Install Zeptap and check your hardware | Install |
| Pair an iPhone for the first time | Set up an iPhone |
| Chat using your Claude or ChatGPT subscription, or an OpenRouter key | Use your own AI account |
| Add Zeptap to an agent | Connect an agent |
| Look up a tool's arguments | Tool reference |
| Make an agent reliable on a real phone | Driving the iPhone |
| Warm up a new Instagram, TikTok or Reddit account | Playbooks |
| Let agents unlock a locked phone | Lock and unlock |
| Fix a tool that errors or a blank screen | Troubleshooting |
How it works
| Channel | Transport | What it carries |
|---|---|---|
| Screen | USB (CoreMediaIO / AVFoundation) | Live video of the iPhone screen, used for the mirror, screenshots and on-device OCR |
| Touch and keyboard | Bluetooth HID (the Mac acts as a keyboard and pointer) | Taps, drags, swipes, typing and key presses, via AssistiveTouch on the iPhone |
| Device control | USB (lockdown) | Trust, device name and model, turning AssistiveTouch on, and locking the screen |
| Agents | Local MCP over HTTP | 17 tools; every action returns a screenshot taken after the screen stops moving |
For agents reading this
- Every page is available as markdown: append
.mdto its URL, or request the page withAccept: text/markdown. /docs/llms.txtindexes every page;/docs/llms-full.txtis the whole manual in one file.- The MCP server also sends a short set of operating rules in its
initializeresponse. Driving the iPhone expands on them.