Zeptap — Claude Code MCP server: what it does, how to install
Zeptap is a Claude Code MCP server that controls a real iPhone through a Mac, with screenshots, OCR, taps, and text input. It runs during tests on a physical iOS device.
MIT ★ 10 updated 2026-10-21
claude mcp add zeptap -- npx -y @zeptap/mcpWhat Zeptap does
Zeptap gives an AI agent control of a real iPhone connected to a Mac. The agent can inspect the current screen, read visible text with OCR, tap coordinates or labels, type text, open installed apps, scroll, and return a settled screenshot after each action. The local MCP endpoint is http://127.0.0.1:47801/mcp; it accepts connections from the same Mac only.
The setup needs a Mac running macOS 14 or later, Bluetooth, an iPhone, and a USB cable. The phone must be trusted over USB and paired through Bluetooth, while no iPhone app is installed. Zeptap for Mac is free for the first hour, then costs $25/month, $99 once, or $199 once for up to 5 iPhones.
What it helps with
- test an iOS app on a physical iPhone
- capture each screen in an app flow
- locate visible labels with on-device OCR
- carry out taps, typing, and swipes on the phone
Example prompts for the agent
- Open the app on the iPhone and show me its current screen through Zeptap.
- Use
find_textto locate “Settings”, then tap that label. - Launch the app, walk through signup on the iPhone, and capture a screenshot after each step.
How to install Zeptap
Platform CLI
claude mcp add zeptap -- npx -y @zeptap/mcpPlatform CLI
codex mcp add zeptap -- npx -y @zeptap/mcpConfig file
{
"mcpServers": {
"zeptap": {
"command": "npx",
"args": [
"-y",
"@zeptap/mcp"
]
}
}
}Config file
{
"servers": {
"zeptap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zeptap/mcp"
]
}
}
}Platform CLI
gemini mcp add zeptap npx -y @zeptap/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Zeptap
How do I install Zeptap in Claude Code?
Run claude mcp add zeptap -- npx -y @zeptap/mcp. Then open the Zeptap Mac app and connect the iPhone.
What does Zeptap do?
Zeptap exposes a real iPhone to an AI agent through a local MCP server. The agent can inspect the screen, read text, tap controls, type, open apps, and receive a screenshot after an action.
What does Zeptap require to work?
It requires a Mac with macOS 14 or later, Bluetooth, an iPhone, a USB cable, and the Zeptap Mac app. The phone setup includes USB trust and Bluetooth pairing; the Mac app becomes paid after the first hour.