# Phone Harness MCP Server (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.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/phone-harness/mcp |
| GitHub stars | 809 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: phone-harness-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Developer tools |
| Latest release | none |
| Last commit | Nov 2, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

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

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

### Cursor (.cursor/mcp.json)

```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)

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

Config formats checked against the official docs on 2026-10-07.

## Tools

- `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.

## Similar MCP servers

- [Idea Reality MCP](https://appsgit.com/mcp-servers/idea-reality-mcp): Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal. (832 stars, MIT)
- [Orcareplay](https://appsgit.com/mcp-servers/orcareplay): Read, replay and fork recorded coding-agent runs. (806 stars, Apache-2.0, official)
- [Codeman](https://appsgit.com/mcp-servers/codeman): Start, prompt and read AI coding agent sessions (Claude Code, Codex, Gemini CLI and more) in Codeman. (841 stars, MIT, needs API key)
- [AnythingMCP](https://appsgit.com/mcp-servers/anythingmcp): MCP gateway and company brain: 732 connectors (SAP, ERP, SQL), file search, memory and skills. (796 stars, AGPL-3.0)
- [Projectmem](https://appsgit.com/mcp-servers/projectmem): Coding agent memory — one local MCP server for every project. (882 stars, MIT)
- [Awwwards MCP](https://appsgit.com/mcp-servers/awwwards-mcp): Free, open-source MCP server that gives AI coding agents (Claude Code, Codex, Cursor, OpenCode, ZCode…) design inspiration from award-winning websites — search with real screenshots, pull design… (788 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/phone-harness-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
