A hosted Android MCP server for Claude Code, Cursor and any MCP client.

Watch the 3-minute setup video: adding the server to Claude Code, then a real run that installs an APK and taps through an app, with the full transcript.

Why a hosted MCP server

Most Android MCP servers wrap ADB. They work, as long as there is an emulator or a USB-connected phone on the same machine as your agent. That rules out most cloud agent sandboxes, remote dev boxes and every teammate who does not want Android Studio eating their RAM.

A hosted server moves the phone to the cloud. Your agent connects to a URL, and Phonebox brings the device, keeps it signed in between sessions and parks it when the agent is idle.

Local ADB-based MCP servers compared with Phonebox
Local ADB MCP serverPhonebox hosted MCP
Where the phone runsAn emulator or USB phone on your machinePhonebox's cloud
SetupAndroid SDK, ADB, an emulator imageOne URL and an API key
Works from CI or a sandboxOnly with nested virtualization or a deviceYes
State between sessionsWhatever your emulator keepsApps, files and sign-ins kept while parked
Human handoffSomeone at the machineA live view link in any browser
CostYour hardware$0.06 per phone-minute; parked phones free

Connect in one command

Create an API key in the console, or let the setup prompt do it for you. Then add the server to Claude Code:

Claude Code
claude mcp add --transport http phonebox https://phonebox.dev/mcp \
  --header "Authorization: Bearer $PHONEBOX_API_KEY"

To share the server with a repository without sharing a key, commit an .mcp.json that reads the key from each person's environment:

.mcp.json
{
  "mcpServers": {
    "phonebox": {
      "type": "http",
      "url": "https://phonebox.dev/mcp",
      "headers": { "Authorization": "Bearer ${PHONEBOX_API_KEY}" }
    }
  }
}

For Cursor, add the server to ~/.cursor/mcp.json, or to .cursor/mcp.json in one project. Keep files that hold a key out of version control.

~/.cursor/mcp.json
{
  "mcpServers": {
    "phonebox": {
      "url": "https://phonebox.dev/mcp",
      "headers": { "Authorization": "Bearer pbx_…" }
    }
  }
}

For Codex, add it to ~/.codex/config.toml. Step-by-step pages for each client: Codex, Cursor, Gemini CLI, Windsurf, Cline and GitHub Copilot.

~/.codex/config.toml
[mcp_servers.phonebox]
url = "https://phonebox.dev/mcp"
bearer_token_env_var = "PHONEBOX_API_KEY"

The tools your agent gets

Phonebox MCP tools
ToolWhat it does
create_phoneCreates a cloud Android phone and waits until it is ready
observeReads the screen as numbered text, plus a 720-pixel screenshot
actRuns up to 20 actions in order: tap, type, swipe, scroll, open an app, wait
install_appInstalls from an https link to an APK, your own uploaded APK, or the app library
create_app_upload / complete_app_uploadUploads your APK with one curl command
live_view_urlA link for a person to watch and control the phone
start_phone / park_phoneResumes a parked phone, or parks it to stop billing
list_phones / get_phone / list_apps / reboot_phoneFind phones, wait for them, list apps, restart a stuck phone

Tools carry the standard MCP hints, so clients that ask before destructive steps know that observe only reads and act can change the phone. There is no delete or reset tool: wiping a phone takes the API or CLI with an Admin key.

Try it

With the server connected, ask your agent for something you can check yourself:

Example task
Use Phonebox to install ./app.apk and check the welcome screen.
Read the screen before each action and confirm the result.
Ask me before signing in or submitting anything.
Park the phone when you finish.

The full tool reference, waiting behaviour and error format are in the MCP documentation. For the bigger picture, read cloud phones for AI agents.

For Android app testers

Questions

What is an Android MCP server?

An Android MCP server exposes an Android device to an AI agent as Model Context Protocol tools: read the screen, tap, type, swipe, open apps and install APKs. Local servers such as mobile-mcp and Appium MCP drive an emulator or USB phone on your machine over adb. Hosted servers such as Phonebox include the phone, so the agent needs only a URL and an API key.

Is there an MCP server for Android?

Yes. Phonebox runs a hosted Android MCP server at https://phonebox.dev/mcp. It speaks Streamable HTTP and authenticates with a Phonebox API key, and its tools create cloud Android phones, read the screen, run actions, install apps and park phones.

Do I need ADB, Android Studio or an emulator for the Phonebox MCP server?

No. The phones run in Phonebox's cloud. Your MCP client only needs network access and an API key; nothing Android-related runs on your machine.

Which MCP clients work?

Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Cline, GitHub Copilot in VS Code and any client that supports Streamable HTTP and can send an Authorization header. The server does not use OAuth.

What does an Android MCP server cost?

The MCP server itself is free to connect. Phones cost $0.06 per phone-minute while running, billed per second with a one-minute minimum, and nothing while parked. New accounts start with a free 7-day trial, card required.

Can the MCP server install my own APK?

Yes. create_app_upload returns a one-off upload URL and a curl command, complete_app_upload processes the APK, and install_app installs it and waits until the phone lists it.

Get started with Phonebox. New accounts start with a free 7-day trial, card required.

The Phonebox team

← All guides