Skip to content
appsgit

Phone Harness MCP Server

Phone Harness MCP Server is an MCP server that connects AI agents to real iPhones and Androids. It has 809 GitHub stars, is released under the MIT license and runs locally with uvx phone-harness-mcp. It works with Claude Desktop, Claude Code, Cursor and VS Code.

github.com/phone-harness/mcp (opens in a new tab)

Data as of from the GitHub API; description from the project's repository. Report an error

Install Phone Harness MCP Server

Generated from the server's published package. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "phone-harness-mcp-server": {
      "command": "uvx",
      "args": [
        "phone-harness-mcp"
      ]
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --transport stdio phone-harness-mcp-server -- uvx phone-harness-mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "phone-harness-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "phone-harness-mcp"
      ]
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "servers": {
    "phone-harness-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "phone-harness-mcp"
      ]
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Tools (14)

Parsed from the Tools section of the README; check the repository for the current list.

  • phone_list_available_devices

    Running phones and their ids, the phones the account can start, and the account balance when the API reports one.

  • phone_start_device

    Start a phone and wait until it is ready. With nothing named, a temporary Android emulator starts.

  • phone_stop_device

    End the session. Anything not saved on the phone is lost. Stopping cloud Android stops the per-minute charge.

  • phone_get_screen_size

    Screen size in the coordinate space taps and swipes use.

  • phone_take_screenshot

    JPEG of the screen. Long side at most maxsize (default 1024), or scale.

  • phone_list_elements_on_screen

    Visible text with tap-ready centers (text or json). Accessibility tree on Android; text recognition on iPhone.

  • phone_click_on_screen_at_coordinates

    Tap x, y.

  • phone_long_press_on_screen_at_coordinates

    Press and hold x, y for duration milliseconds (default 800, clamped to 100–10000).

  • phone_swipe_on_screen

    Swipe. direction is the way the finger moves (up reveals what is below).

  • phone_type_keys

    Type text into the focused field. submit presses Enter.

  • phone_press_button

    HOME, BACK (Android only), APPSWITCHER, or ENTER.

  • phone_list_apps

    Installed apps: package ids on Android, bundle ids on an iPhone, when the phone can list them.

  • phone_launch_app

    Open an app by the name on its icon, or on Android by package id.

  • phone_get_foreground_app

    Which app is in front, when the phone reports it.

About Phone Harness MCP Server

Give any MCP agent a real iPhone or an Android emulator in the cloud. Add Phone Harness as a custom connector in Claude, Cursor, ChatGPT, Codex, or any MCP client, and your agent can see the screen, tap, type, swipe, and open apps on a real iPhone or an Android emulator.

  • ai-agents
  • android
  • iphone
  • mcp
  • mcp-server
  • mobile-automation
  • model-context-protocol
  • phone-automation

FAQ

Phone Harness MCP Server FAQ

Still curious? Email info@appsgit.com.

How do I install the Phone Harness MCP Server MCP server?

Add the command uvx phone-harness-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Phone Harness MCP Server free?

The server is open source under the MIT license, so running it is free. It does not declare any required API key.

Is Phone Harness MCP Server actively maintained?

The most recent commit was on Nov 2, 2026. appsgit only lists MCP servers with a commit in the last six months.