Claude connector
0bull Phone Control lets Claude see and operate the real iPhones you rent on 0bull. Claude can take a screenshot, read the text on screen, tap, swipe and type, send device commands, replay macros you recorded, and hand a task to the on-phone AI agent.
The connector is served at:
Code
It is a smaller server than the full 0bull Phone Farm server at
https://0bull.net/mcp. It only controls phones. It has no billing, posting accounts,
video publishing or automations.
Before you start
- A 0bull.net account.
- At least one phone on that account. Rent one or ask a team owner to share one with you.
- The phone must be online.
list-phones-toolshowsvideo_live: truefor a phone Claude can use.
Connect it in Claude
- In Claude, open Settings → Connectors and find 0bull Phone Control in the
directory. If it is not there yet, choose Add custom connector, name it
0bull Phone Controland pastehttps://0bull.net/mcp/phone. - Choose Connect. A 0bull window opens.
- Log in with your 0bull account and choose Authorize.
There is no API key to copy. Claude only sees the phones your own account can reach.
In Claude Code:
Code
Then run /mcp, pick 0bull-phone and authenticate in the browser.
Tools
| Tool | Title | What it does |
|---|---|---|
list-phones-tool | List phones | Your phones, with the slot id every other tool takes, whether each is live, and whether you may control it. |
phone-snapshot-tool | Take phone screenshot | A JPEG of the phone screen right now. |
phone-ocr-tool | Read phone screen text | The text on screen, cheaper than an image when you only need words. |
phone-control-tool | Tap, swipe or type on a phone | One input: tap, swipe, a key such as home or back, or typed text. |
phone-command-tool | Send phone command | Clipboard, open a URL or deep link, brightness, Wi-Fi, airplane mode, cellular, flashlight, clear the camera roll, read the LAN IP. |
list-macros-tool | List macros | The macros you recorded in 0bull. |
run-macro-tool | Run macro | Replays a macro exactly as recorded, on one phone. |
run-phone-agent-tool | Run phone agent task | Gives the on-phone AI agent one task in plain words. |
list-phone-runs-tool | List phone runs | Recent commands, macros and agent tasks on a phone, with their status. |
get-phone-run-tool | Get phone run | One run's status, result or error. |
The screenshot, screen text and list tools only read. Claude can run them without asking. Every tool that acts on a phone is marked destructive, so Claude asks you before each call. Some actions cannot be undone, such as clearing the camera roll or sending a message in an app.
Commands, macros and agent tasks run in the background. The call returns a run id at once,
and Claude checks get-phone-run-tool until the run finishes. Taps, swipes, typing,
screenshots and screen text return straight away.
Example prompts
- "Show me what's on my 0bull phone right now."
- "On my iPhone, open Settings and turn on Wi-Fi, then take a screenshot so I can check."
- "Open https://example.com in Safari on my phone and read me the headline."
- "List my macros, run the first one on my phone and tell me when it finishes."
- "Ask the phone agent to open the App Store and check for updates, then show me the result."
- "Copy this text to my phone's clipboard: meet at 6pm."
Troubleshooting
- "No phones" or an empty list. Your account has no phone yet, or the phone you rented has not been assigned. Check your dashboard.
video_live: false. The phone is offline or restarting. Wait a minute and ask again. If it stays offline, contact support.can_control: false. Someone shared the phone with you as view-only. Claude can take screenshots and read the screen but cannot tap or run anything.- A macro or agent task failed. Ask Claude for the run's
error, or take a screenshot. Macros replay exact taps, so they fail when the screen is not where the recording started. - Claude asks you to sign in again. Your authorization expired or was revoked. Choose Connect again in Settings → Connectors.
Data and privacy
Screenshots and screen text are read live from the phone and sent to Claude. The connector does not save them. Commands, macros and agent tasks are kept in the phone's run history with their status and result, so you can check them later in 0bull. See the privacy policy and terms.
Support
Email support@0bull.net. Report security issues to the same address.

