Skip to content
MCP server

Zeptap

Let AI agents see, tap and type on a real iPhone mirrored through a Mac app

Runs locallyStatus and history
Install
Pricing
Free trial
Platforms
macOS, iOS, CLI
Runs
Locally
Version
1.0.1
Listing updated
2 days ago

About Zeptap

Zeptap is an MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "zeptap": {
      "command": "npx",
      "args": [
        "-y",
        "@zeptap/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "zeptap": {
      "command": "npx",
      "args": [
        "-y",
        "@zeptap/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (19)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free trial, from $25 a month

First hour free; $25/mo, $99 once, or $199 once for up to 5 iPhones

Prices change. Check zeptap.com before you buy.

Zeptap 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 to Zeptap

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity