Browse documentation

Use Phone Use

Connect an MCP client

Expose Phone Use tools to Claude Code, Codex, or another MCP-compatible client.

Register the server

bashphone-use
claude mcp add --scope project phone-use -- bunx phone-use mcp

Choose a device

ValueBehavior
launchCreate and boot a dedicated simulator; delete it on exit
connectAttach to the first booted simulator
Simulator UDIDAttach to that simulator

Live viewer

Starting the MCP server also starts the browser viewer at http://localhost:4936.

Tool selection

  • Use ask, goto, search, or toggle when the intent is known.
  • Use a saved skill for an established multi-step workflow.
  • Use observe, tap, type, and scroll for unfamiliar interfaces.
  • Use coordinates only when no reliable semantic target exists.