Zeptap

io.github.ZeptapPublished by GitHub account Zeptapv1.0.1Updated Oct 25, 2026

Operate a real iPhone from a Mac: screenshots, OCR, taps, typing, opening apps. Needs Zeptap.

VerifiedSTDIODesktop onlyLocation & LifestyleBrowser AutomationDeveloper Tools

Overview

AI-generated overview

Lets an AI assistant see and control a real iPhone from a Mac: screenshots, OCR, taps, swipes, typing and app launching.

What you can do
List connected iPhones and capture the current screen as an image, with on-device OCR to find visible text and a wait tool for settled screenshots. Tap, double-tap, long-press, tap a text label, drag and flick to scroll. Type text, press keys with modifiers, and use home, back and dismiss to navigate. Open installed apps by name, and optionally lock or unlock the phone with a passcode stored in the Keychain. Every action returns a fresh screenshot so the assistant can check its own work.
When to use it
Useful for testing your own iOS apps on a physical device, walking through signup or UI flows, capturing screens of an app, or handing everyday phone tasks to an assistant. It drives a real cabled iPhone, not a simulator or Android device.
Requirements
A Mac on macOS 14 or later with Bluetooth, the closed-source Zeptap Mac app running, an iPhone connected by USB and paired over Bluetooth, and a local MCP endpoint on loopback. Clients can connect over HTTP or through the npm stdio relay, which needs Node.js; the ZEPTAP_BIN variable points at the app if it is not in Applications.
Before you install
The server has no authentication and accepts only local connections, but anything on the same Mac that reaches it can control the phone. Actions tap, type, open apps and can lock or unlock the device; unlocking needs a passcode saved in the Keychain. Screenshots of the phone screen go to the connected assistant. The Mac app is paid after a first free hour, and the repo warns against fake engagement, bulk account creation and device spoofing.

Installation

In SourceWeft

  1. Open Zeptap in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Zeptap: let Claude Code test your app on a real iPhone]

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.

[Download for Mac]   [Tool reference]   [Pricing]

[MCP: Streamable HTTP and stdio] [macOS 14 or later] [First hour free] [This repo is MIT licensed]

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
sh
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:

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

~/.cursor/mcp.json:

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

~/.codex/config.toml:

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

.vscode/mcp.json:

json
{ "servers": { "zeptap": { "type": "http", "url": "http://127.0.0.1:47801/mcp" } } }
Claude Desktop and other stdio clients
json
{ "mcpServers": { "zeptap": { "command": "npx", "args": ["-y", "@zeptap/mcp"] } } }

Or without Node:

json
{ "mcpServers": { "zeptap": { "command": "/Applications/Zeptap.app/Contents/MacOS/Zeptap", "args": ["--stdio"] } } }

Check it works (with Zeptap open):

sh
curl -s http://127.0.0.1:47801/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

ToolWhat it does
list_phonesThe iPhones connected to this Mac, with ids to pass as phone
screenshotCurrent iPhone screen as an image
find_textOn-device OCR of screen text, optional filter
waitWait, then return a settled screenshot
load_skillReturn a built-in app guide
tap, double_tap, long_pressTouch at x, y
tap_textTap a visible text label
drag, flickDrag between points, or scroll in a direction
type_text, press_keyType text, or press a key with modifiers
home, back, dismissHome Screen, go back, close sheets or keyboard
open_appOpen an installed app by name
lock, unlockLock over USB, unlock with a passcode saved in the Keychain (opt in)

Every action returns a screenshot after the screen settles. Every tool except list_phones takes an optional phone; without it, tools act on the iPhone that is active in Zeptap. Full reference: zeptap.com/docs/agents/tools.

What's in this repo

PathWhat it is
skills/zeptap/SKILL.mdAgent skill: connection check, look-act-verify loop, when to ask first. Copy to ~/.claude/skills/ or install the plugin
.claude-plugin/Claude Code plugin and marketplace manifest
.mcp.jsonMCP config the plugin installs
bin/zeptap-mcp.js@zeptap/mcp, a stdio relay that starts Zeptap --stdio. Set ZEPTAP_BIN if the app is not in /Applications
server.json, smithery.yamlRegistry manifests

FAQ

Does it work with Android or the iOS Simulator?

No. Zeptap drives a real iPhone that is cabled to the Mac. Windows, Linux and remote phones are not supported either.

Can it run several iPhones?

Yes. Call list_phones, then pass phone on each call. Calls for different phones run side by side. Up to 5 iPhones need the Lifetime Plus license.

What is it for?

Testing your own iOS apps and automating your own accounts and apps. Not for fake engagement, bulk account creation or device spoofing.

Support

Email [email protected] or read the docs. Errors are covered in troubleshooting.

Made by Afterlume Labs

Source: README.md at commit 9ab78be

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestOct 15, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts