# Zeptap

> Zeptap is an MCP server for developer tools. Let AI agents see, tap and type on a real iPhone mirrored through a Mac app. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $25 a month
- **Platforms:** macOS, iOS, CLI
- **Website:** https://zeptap.com/docs
- **Repository:** https://github.com/zeptap/mcp
- **MCP Registry name:** io.github.Zeptap/zeptap
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-15

## About

Zeptap is a macOS app, and this MCP server is how agents drive it. The Mac reads the iPhone's screen over USB and sends taps and typing over Bluetooth as a keyboard and pointer using AssistiveTouch. Nothing is installed on the phone, with no Xcode, Developer Mode or Apple Developer account, and the only phone step is Bluetooth pairing. The docs say it works on a real device, not a simulator, so App Store apps, Settings, Safari and TestFlight builds are reachable.

The server runs locally at 127.0.0.1:47801, accepts loopback connections only and needs no key. The docs say 19 tools exist and every action returns a screenshot taken after the screen settles, so the agent can check its own work. The npm package is a stdio relay for clients that cannot speak HTTP. Use it to test your own iOS apps or hand everyday phone tasks to an agent.

The Mac app is closed source, with the repository's configs, plugin and skill under MIT. It requires macOS 14 or later, Bluetooth, an iPhone and a USB cable.

## Features

- **Real device control:** Taps, drags, swipes and types on a physical iPhone.
- **Screenshots after actions:** Every action returns a screenshot once the screen stops moving.
- **On-device OCR:** Reads screen text and can tap a visible label.
- **Nothing on the phone:** Needs no Xcode, Developer Mode or developer account.
- **Loopback-only server:** Accepts connections only from the same Mac.
- **Lock and unlock:** Lets agents lock and unlock the phone.

## Good for

- Walk through signup in your own iOS app on a real device
- Screenshot every screen in dark mode
- Change a setting such as Low Power Mode
- Find a saved Wi-Fi password in Settings
- Test TestFlight builds without a simulator

## Install

### Claude Code (Terminal)

```sh
claude mcp add zeptap -- npx -y @zeptap/mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "zeptap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zeptap/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `list_phones`: Lists the iPhones connected to the Mac.
- `screenshot`: Returns the current iPhone screen as an image.
- `find_text`: Runs on-device OCR on screen text with an optional filter.
- `wait`: Waits, then returns a settled screenshot.
- `load_skill`: Returns a built-in app guide.
- `tap`: Taps at x, y.
- `double_tap`: Double-taps at x, y.
- `long_press`: Long-presses at x, y.
- `tap_text`: Taps a visible text label.
- `drag`: Drags between points.
- `flick`: Scrolls in a direction.
- `type_text`: Types text.
- `press_key`: Presses a key with modifiers.
- `home`: Goes to the Home Screen.
- `back`: Goes back.
- `dismiss`: Closes sheets or the keyboard.
- `open_app`: Opens an installed app by name.
- `lock`: Locks the iPhone.
- `unlock`: Unlocks the iPhone.

## FAQ

### What does it cost?

The first hour of live use is free, then $25 a month, $99 once, or $199 once for up to 5 iPhones.

### What do I need?

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

### Does anything leave my Mac?

The docs say the server is local only and screenshots go only to the agent you connect.

### Which agents work?

Claude Code, Claude Desktop, Codex, Cursor and VS Code are covered by the README's setup examples.

### Is Zeptap free?

Zeptap is a paid product with a free trial. Paid plans start at $25 a month.

### How do I add Zeptap to Claude Code?

Run this command in your terminal: claude mcp add zeptap -- npx -y @zeptap/mcp

### What are the best alternatives to Zeptap?

The closest alternatives to Zeptap are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/zeptap
