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

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 cloud sandboxes, CI runners, 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.

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

{
  "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.

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

The tools your agent gets

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:

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.

Questions