Zeptap MCP server

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.

   

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 Code

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

Or install the plugin, which adds the server and the skill:

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

Cursor

~/.cursor/mcp.json:

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

Codex

~/.codex/config.toml:

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

VS Code

.vscode/mcp.json:

Shortened. The full README is on GitHub.