Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

phone-harness/mcp

AI Engineering

A hosted MCP server that lets AI agents control real iPhones and Android emulators in the cloud.

812
71
Python
MIT
26 days old

What it does

Phone Harness exposes a hosted Model Context Protocol (MCP) server that gives an MCP agent a real cloud iPhone or Android emulator to operate. Instead of setting up a Mac, adb, or device pairing, you add a remote streamable HTTP endpoint to your MCP client, sign in with OAuth (or an API key), and the agent can list devices, start a phone, take screenshots, inspect on-screen text, tap, swipe, type, press buttons, and launch apps.

The repository is the MCP server implementation (Python, MIT licensed). The actual phones run in the cloud behind the hosted endpoint, so this project is aimed at teams and developers who want an agent to perform mobile tasks without maintaining local device infrastructure.

The hosted server registers tools such as phone_list_available_devices, phone_start_device, phone_take_screenshot, phone_list_elements_on_screen, phone_click_on_screen_at_coordinates, phone_swipe_on_screen, and phone_type_keys. Tool names follow mobile-mcp.

Quick start

  1. Open your MCP client's remote server settings. For Claude, use Customize → Connectors → Add custom connector (or the Add to Claude button). For Cursor, add an entry to ~/.cursor/mcp.json or .cursor/mcp.json:
{
  "mcpServers": {
    "phone-harness": {
      "url": "https://mcp.phone-harness.com/mcp"
    }
  }
}
  1. Use the endpoint https://mcp.phone-harness.com/mcp and complete the OAuth sign-in, which requests the phone:drive scope. If you prefer an API key, send Authorization: Bearer pck_… as a header instead of signing in.

  2. In the agent session, call phone_start_device (a temporary Android emulator starts if you name nothing), then use the other tools to interact with the screen and apps. Call phone_stop_device when finished.

If you want to run the server yourself, the README points to the self-hosting guide; it covers local stdio, Docker, and Vercel deployment.

Constraints

  • The hosted service is not free. Android emulators are billed per phone-minute after a free start, and cloud iPhones are billed as a flat monthly subscription; see the pricing page for current rates.
  • The minutes argument on phone_start_device controls session length (default 30) and is not a billing unit. Anything not saved on the phone is lost when the session stops; stopping a cloud Android ends the per-minute charge.
  • There is no tool that opens a URL, so agents must launch apps and navigate manually. phone_save_screenshot is only registered by the local stdio server, not the hosted one.
  • iPhone control requires an account with an iPhone subscription, and on ChatGPT web the custom MCP server functionality is limited to Business, Enterprise, and Edu workspaces for driving the phone.

HotRepo's take

The repository has no recorded HotRepo daily ranking, snapshot, or Hacker News discussion data, so there is no measured popularity trend to report. What is visible is a coherent MCP tool surface, a single hosted URL, and setup instructions for a long list of MCP clients, from Claude and Cursor to Claude Code, Codex, VS Code, and Gemini CLI. The main practical trade-off is that the useful capability depends on the paid cloud phone service, while the server code is MIT licensed and can be self-hosted.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. hridaya423/phonedriverMCP server and CLI that let AI agents read and control Android phones and iPhones with a confirmation step before payments.Rust150
  2. JosssphZhou/pokiLet Claude Code, Codex, or other MCP clients drive a real iPhone from a Mac, without jailbreak or extra hardware.JavaScript109
  3. droidrun/mobilerunAn LLM-agnostic framework that lets AI agents inspect, tap, swipe, and type on real Android and iOS devices via CLI or Python.Python10,059
  4. ZSeven-W/dsh-androidDeepSeek Harness plugin that streams a live Android emulator or USB device into the conversation and drives it through adb.TypeScript355
  5. ZSeven-W/dsh-iosGives coding agents 22 tools to boot, build, and drive iOS Simulators or USB-connected iPhones, with a live interactive sidebar.TypeScript469