Give Cursor an Android phone: an Android MCP server for Cursor's agent.

Set it up

1. Get a key. Paste this into Cursor's agent. It installs the Phonebox CLI and signs you in; the key is saved on your machine, not in the chat.

Read https://phonebox.dev/setup.md and set me up with Phonebox from here: get me signed in and ready, then find out what I want to use phones for and help me with that.

2. Add the server for every project in ~/.cursor/mcp.json, with your key in place of pbx_…:

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

Or for one project, commit .cursor/mcp.json and let each person's environment hold the key:

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

export PHONEBOX_API_KEY=$(phonebox token)

Open Cursor's MCP settings and check that phonebox shows its 13 tools.

The loop Cursor gets

Build the debug APK and install it on my Phonebox phone.
Walk through the onboarding and settings screens I changed in this branch.
Read the screen before every action. Report anything that looks broken,
with the screen text you saw. Park the phone when you finish.

When a step needs a person, such as a one-time code sent to your own phone, the agent calls live_view_url and hands you a link to the phone.

Related

• Android MCP server: every tool, and how hosted compares with ADB-based servers.
• Give Codex an Android phone and the Claude Code setup video.
• Test your Android app with an AI agent.

Questions