Agent Bridge: give your AI agent a real phone

Give your AI agent a real phone. Claude Code, Cursor, Antigravity and any MCP client can see your Android screen, tap, type, open apps and move files.

Get the Android appUSB or Wi-Fi

$npx android-agent-bridge start

— app downloads— npm installs— GitHub starsMIT open source

Claude Code✦Cursor✦Antigravity✦Windsurf✦VS Code✦Any MCP client✦Shell scripts✦Samsung✦Pixel✦Xiaomi✦OnePlus✦Motorola✦

File 001 · Why this exists

Your agent can write code, search the web and run your terminal. It has never held a phone. Agent Bridge hands it yours. It reads the screen, taps, types, opens apps, turns the volume down and sends you the file. No emulator. No cloud. No account. One npx command and a QR code.

Live session · recorded on a real phone

Open

It launches any app by name, then reads the screen as a numbered list.

OpenTapChooseAct

claude → phone

phonectl launch Uber

Opened Uber (com.ubercab)

[18] item "Where to?" @540,355

[2] item "DB Mall · Zone-I" @540,563

What it can do

Everythingyoudoonaphone.

18246910

Sees the screen

A numbered list of every button, field and line of text, plus screenshots with each element boxed. It knows what is hidden under sheets and dialogs.

phone_screenphone_elements

“Services” · ocr“Account” · ocr

Reads what apps hide

Many apps hide tab bars and buttons from accessibility. On-device OCR reads the pixels, so “tap Account” still works. Nothing leaves the phone.

phone_ocr

tap 540,355

Acts like a person

Tap by number, text or position. Type straight into fields, scroll, swipe, long-press, Back and Home. Open any app by name or from the Play Store.

phone_tapphone_typephone_open_app

Media

Ring

Bright

Alarm

TorchDNDRotateWi-Fi

Runs the device

Volume for every stream, brightness, flashlight, rotation, Do Not Disturb, any settings page, links, the dialer, battery and notifications.

phone_volumephone_togglephone_settings

AirDrop, both ways

Send from the terminal or drag onto localhost:8350/drop. Share from any phone app to the computer. Wi-Fi, hotspot or USB, no size limit.

phone_send_filesphone_received_files

5.0678910111213141516

Old phones welcome

Works back to Android 5.0 from 2015. Where old Android can't do something itself, the computer does it over USB.

Android 5 → 16

Quick start

Upintwominutes.

Install the app

Turn on USB debugging and plug in. The CLI installs the app and switches it on. Or download the APK.

$npx android-agent-bridge usb

Start the bridge

Open Agent Bridge on the phone and scan the QR. It reconnects by itself after that.

$npx android-agent-bridge start

Connect your agent

Add the MCP server, restart the agent and ask it to use the phone.

$npx android-agent-bridge init

terminal

claude mcp add phone -- npx -y android-agent-bridge

Try it

Justask.

Paste any of these into your agent once the phone is connected. Click to copy.

More prompts and the full setup guide →

The numbers · live from GitHub and npm

Departuresboard

Flight AB-01 · computer → phoneBoarding

App downloads

npm installs · 12 mo

GitHub stars

Agent tools

Oldest Android

Price

Compatibility

TenyearsofAndroid.

Version	Read screen	Tap by element	Tap by position	Screenshots	Wi-Fi & USB
Android 11 – 16	✓	✓	✓	✓	✓
Android 7 – 10	✓	✓	✓	One-time prompt	✓
Android 5 – 6	✓	✓	Over USB	One-time prompt	✓

Tested on Samsung, Pixel, Xiaomi and OnePlus phones. Works on Windows, macOS and Linux with Node 20 or newer.

Security & privacy

Yourphone.Yourrules.

Paired, not public

Only a computer holding the secret from your QR code can connect. Make a new one any time with pair --reset.

Stays on your network

The phone talks to your computer over Wi-Fi or USB. No cloud, no account, no analytics.

On-device OCR

Text recognition runs on the phone. Screenshots go to your computer and nowhere else.

One switch to stop

Turn off the accessibility service and access ends at once. Forget the computer from the app.

Agents ask first

The bundled guide tells agents to ask before paying, posting, sending or deleting, and never to type passwords.

Open source, MIT

Every line of the app, bridge and MCP server is on GitHub. Read it, fork it, audit it.

FAQ

Questions

Q01Play Protect says “App blocked to protect your device”

Google blocks sideloaded apps that use accessibility when they're opened from a browser or chat app. Install over USB with npx android-agent-bridge usb. After that, Wi-Fi works too.

Q02Is my phone exposed to the internet?

No. Only a computer that scanned your QR code can connect, over your own Wi-Fi or USB.

Q03Does it work on iPhone?

No. It relies on Android's accessibility service, which iOS doesn't offer to apps.

Q04Can it control banking and streaming apps?

Those apps block screenshots, so the screen comes out black. Their element list often still works, but some screens stay off-limits by design.

Q05Do I need USB?

Only to install the app the first time. Day to day it works over the same Wi-Fi or a hotspot.

Q06Which agents work?

Anything that speaks MCP: Claude Code, Cursor, Antigravity, Windsurf, VS Code and others. Shell scripts can use the CLI directly.

Q07What does it cost?

Nothing. It's open source under the MIT license.

Still here? Good.

Handyouragentthephone.

Download the app, run one command, scan the code.

Get the Android app

$npx android-agent-bridge start