# Zeptap

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10 repo stars
- Author: Zeptap
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Zeptap/mcp
- Updated: 2026-10-21
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/zeptap

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add zeptap -- npx -y @zeptap/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add zeptap -- npx -y @zeptap/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zeptap": {
            "command": "npx",
            "args": [
                "-y",
                "@zeptap/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "zeptap": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@zeptap/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add zeptap npx -y @zeptap/mcp
```

## When to use it
- 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
- Open the app on the iPhone and show me its current screen through Zeptap.
- Use `find_text` to locate “Settings”, then tap that label.
- Launch the app, walk through signup on the iPhone, and capture a screenshot after each step.

## Similar
- [argent-ios-device-interact](https://affpapa.org/en/nevibecode/skills/argent-ios-device-interact.md) — skill · 17100 installs
- [ascript-mcp](https://affpapa.org/en/nevibecode/mcp/ascript-mcp.md) — MCP server · ★ 11 repo stars
- [argent-ios-device-setup](https://affpapa.org/en/nevibecode/skills/argent-ios-device-setup.md) — skill · 17100 installs
- [ios-device-automation](https://affpapa.org/en/nevibecode/skills/ios-device-automation.md) — skill · 3500 installs
- [appium-skill](https://affpapa.org/en/nevibecode/skills/appium-skill.md) — skill · 445 installs
- [phonedriver](https://affpapa.org/en/nevibecode/mcp/phonedriver.md) — MCP server · ★ 342 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
