Zeptap

[Zeptap: let Claude Code test your app on a real iPhone]

Let AI agents see, tap, swipe and type on a real iPhone.
MCP configs, a Claude Code plugin, an agent skill and a stdio relay for the Zeptap Mac app.

[Download for Mac]   [Tool reference]   [Pricing]

[MCP: Streamable HTTP and stdio] [macOS 14 or later] [First hour free] [This repo is MIT licensed]

What it is

Zeptap is a Mac app that lets AI agents operate a real iPhone. The Mac reads the iPhone screen over USB and sends taps and typing over Bluetooth through AssistiveTouch. The app runs a local MCP server at http://127.0.0.1:47801/mcp (Streamable HTTP, loopback only, no auth). Every action returns a screenshot, so the agent checks its own work.

Use it to test your own iOS apps on a physical device, or to hand everyday phone tasks to the agent you already use.

"open my app and walk through signup" · "screenshot every screen in dark mode" · "turn on Low Power Mode" · "find the wifi password in Settings"

This repo holds the client configs, plugin, skill and relay. It does not contain the app.

Good to know

🔌 Nothing to install on the iPhone. No Xcode, no Developer Mode, no Apple Developer account. The only step on the phone is Bluetooth pairing.

📱 Real iPhone, not a simulator. App Store apps, Settings, Safari, Messages, TestFlight builds. If you can tap it, the agent can.

🔒 Local only. The MCP server only accepts connections from the same Mac. Screenshots go only to the agent you connect. See privacy.

💳 Paid Mac app, first hour free. The Mac app is closed source. After the first hour of live use: $25/month, $99 once, or $199 once for up to 5 iPhones. See pricing. Everything in this repo is MIT.

Get started

1. Download Zeptap, or brew install --cask zeptap/tap/zeptap.
2. Connect your iPhone with a USB cable, tap Trust, and pair Bluetooth in the setup assistant.
3. Add the server to your agent (below), then ask it to take a screenshot.

You need: a Mac on macOS 14 or later with Bluetooth, an iPhone, and a USB cable.

Connect your agent

claude mcp add --transport http --scope user zeptap http://127.0.0.1:47801/mcp

/plugin marketplace add zeptap/mcp/plugin install zeptap@zeptap

{ "mcpServers": { "zeptap": { "url": "http://127.0.0.1:47801/mcp" } } }

[mcp_servers.zeptap]url = "http://127.0.0.1:47801/mcp"

{ "servers": { "zeptap": { "type": "http", "url": "http://127.0.0.1:47801/mcp" } } }

{ "mcpServers": { "zeptap": { "command": "npx", "args": ["-y", "@zeptap/mcp"] } } }

{ "mcpServers": { "zeptap": { "command": "/Applications/Zeptap.app/Contents/MacOS/Zeptap", "args": ["--stdio"] } } }

Check it works (with Zeptap open):

curl -s http://127.0.0.1:47801/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

Every action returns a screenshot after the screen settles. Every tool except list_phones takes an optional phone; without it, tools act on the iPhone that is active in Zeptap. Full reference: zeptap.com/docs/agents/tools.

What's in this repo

FAQ

Support

Email [email protected] or read the docs. Errors are covered in troubleshooting.

_{Made by Afterlume Labs}