Skip to content
Back to search

mcp

Connect AI agents to real iPhones and Androids

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/phone-harness/mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/phone-harness/mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/phone-harness--mcp/badge.svg)](/listings/phone-harness--mcp)

HTML

<a href="/listings/phone-harness--mcp"><img src="/api/listings/phone-harness--mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Most clients take this **standard config**:

{
  "mcpServers": {
    "phone-harness": {
      "command": "uvx",
      "args": ["phone-harness-mcp"],
      "env": { "PHONE_HARNESS_API_KEY": "pck_…" }
    }
  }
}

Leave out `env` if the machine is already signed in with `phone-harness cloud login`.

[<img src="https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code">](https://vscode.dev/redirect/mcp/install?name=phone-harness&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22phone-harness-mcp%22%5D%7D) [<img src="https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code Insiders">](https://insiders.vscode.dev/redirect/mcp/install?name=phone-harness&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22phone-harness-mcp%22%5D%7D&quality=insiders) [<img src="https://img.shields.io/badge/Cursor-Install-000000?style=flat-square&logo=cursor" alt="Install in Cursor">](cursor://anysphere.cursor-deeplink/mcp/install?name=phone-harness&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJwaG9uZS1oYXJuZXNzLW1jcCJdfQ==)

<details><summary><b>Claude Code</b></summary>

Local:

claude mcp add phone-harness -e PHONE_HARNESS_API_KEY=pck_… -- uvx phone-harness-mcp

Hosted, signing in with OAuth (run `/mcp` afterwards to authenticate):

claude mcp add --transport http phone-harness https://mcp.phone-harness.com/mcp

Hosted, with an API key instead:

claude mcp add --transport http phone-harness https://mcp.phone-harness.com/mcp \
  --header "Authorization: Bearer pck_…"

</details>

<details><summary><b>Claude.ai and Claude Desktop</b></summary>

Settings → Connectors → Add custom connector, URL `https://mcp.phone-harness.com/mcp`. Claude signs in through Phone Harness's own OAuth consent screen; no key to paste. Or add the standard config to `claude_desktop_config.json` to run it locally. </details>

<details><summary><b>ChatGPT</b></summary>

Add the connector with URL `https://mcp.phone-harness.com/mcp` and sign in when prompted; the consent screen asks for the `phone:drive` scope. </details>

<details><summary><b>Codex</b></summary>

codex mcp add phone-harness --env PHONE_HARNESS_API_KEY=pck_… -- uvx phone-harness-mcp

Or in `~/.codex/config.toml`, hosted:

[mcp_servers.phone-harness]
url = "https://mcp.phone-harness.com/mcp"
bearer_token_env_var = "PHONE_HARNESS_API_KEY"

</details>

<details><summary><b>Cursor</b></summary>

Click the Cursor badge above, or Settings → MCP → Add new MCP Server and paste the standard config into `~/.cursor/mcp.json`. For the hosted server:

{
  "mcpServers": {
    "phone-harness": {
      "url": "https://mcp.phone-harness.com/mcp",
      "headers": { "Authorization": "Bearer pck_…" }
    }
  }
}

</details>

<details><summary><b>VS Code</b></summary>

Click a VS Code badge above, or:

code --add-mcp '{"name":"phone-harness","command":"uvx","args":["phone-harness-mcp"],"env":{"PHONE_HARNESS_API_KEY":"pck_…"}}'

</details>

<details><summary><b>Gemini CLI</b></summary>

Add the standard config under `mcpServers` in `~/.gemini/settings.json`. </details>

<details><summary><b>Copilot CLI</b></summary>

Run `/mcp add`, or put this in `~/.copilot/mcp-config.json`:

{
  "mcpServers": {
    "phone-harness": {
      "type": "local",
      "command": "uvx",
      "args": ["phone-harness-mcp"],
      "env": { "PHONE_HARNESS_API_KEY": "pck_…" },
      "tools": ["*"]
    }
  }
}

</details>

<details><summary><b>Windsurf</b></summary>

Add the standard config to `~/.codeium/windsurf/mcp_config.json`. </details>

<details><summary><b>Goose</b></summary>

Advanced settings → Extensions → Add custom extension, type STDIO, command `uvx phone-harness-mcp`, environment variable `PHONE_HARNESS_API_KEY`. </details>

<details><summary><b>Kiro</b></summary>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 260 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Phone Harness MCP 🔌
  2. **Give any MCP agent a real iPhone or an Android emulator in the cloud.**
  3. 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.
  4. ## Setup
  5. ### General
  6. Streamable HTTP. Sign-in is OAuth and asks for the `phone:drive` scope. An API key can be sent as a bearer token instead; see the FAQ.
  7. https://mcp.phone-harness.com/mcp
  8. [<img src="https://img.shields.io/badge/Add_to-Claude-000000?style=flat-square&logo=claude&logoColor=white" alt="Add to Claude">](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Phone%20Harness&connectorUrl=https%3A%2F%2Fmcp.phone-harness.com%2Fmcp)
  9. [<img src="https://img.shields.io/badge/Add_to-Cursor-000000?style=flat-square&logo=cursor" alt="Add to Cursor">](cursor://anysphere.cursor-deeplink/mcp/install?name=phone-harness&config=eyJ1cmwiOiJodHRwczovL21jcC5waG9uZS1oYXJuZXNzLmNvbS9tY3AifQ==)
  10. [<img src="https://img.shields.io/badge/Add_to-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Add to VS Code">](https://vscode.dev/redirect/mcp/install?name=phone-harness&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.phone-harness.com%2Fmcp%22%7D)
  11. - **Works in any MCP client.** Claude, Cursor, ChatGPT, Codex, VS Code, and more.
  12. - **Nothing to set up.** No Mac, no adb, no pairing. Just a URL and a sign-in.
  13. - **Real iPhones.** Dedicated cloud iPhones, and Android emulators, driven the way a person uses them.
  14. ### Claude
  15. Use the Add to Claude button above, or open **Customize → Connectors** and add a custom connector (**Add → Custom → Web**, or **Add custom connector**). Name it Phone Harness, paste `https://mcp.phone-harness.com/mcp`, choose sign-in rather than No sign in, and add it. On Team and Enterprise, an Owner adds it under **Organization settings → Connectors**; members then connect.
  16. ### Cursor
  17. Use the Add to Cursor button above, or add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project), then restart Cursor. Cursor signs in with OAuth when the server asks.
  18. ```json
  19. {
  20. "mcpServers": {
  21. "phone-harness": {
  22. "url": "https://mcp.phone-harness.com/mcp"
  23. }
  24. }
  25. }
  26. ```
  27. ### ChatGPT
  28. On ChatGPT web, open **Plugins → + → Add custom MCP server**. Name it, paste `https://mcp.phone-harness.com/mcp`, choose sign-in, acknowledge the warning, and select **Create as a plugin**. Install the plugin, then @ mention it in a chat.
  29. Custom MCP servers on ChatGPT web are for Business, Enterprise, and Edu workspaces. An admin creates the plugin. Pro accounts can connect a custom server for read and fetch tools only, so driving the phone needs Business, Enterprise, or Edu.
  30. ### Grok
  31. On [grok.com/connectors](https://grok.com/connectors), choose **New Connector → Custom**, paste `https://mcp.phone-harness.com/mcp`, and complete the sign-in. The server has to be reachable on the public internet.
  32. In the Grok CLI, OAuth runs on first use:
  33. ```bash
  34. grok mcp add --transport http phone-harness https://mcp.phone-harness.com/mcp
  35. ```
  36. ### Claude Code
  37. ```bash
  38. claude mcp add --transport http phone-harness https://mcp.phone-harness.com/mcp
  39. ```
  40. Then run `/mcp` and sign in. That saves the server for the current project; add `--scope user` to keep it in every project.
  41. ### Codex
  42. ```bash
  43. codex mcp add phone-harness --url https://mcp.phone-harness.com/mcp
  44. codex mcp login phone-harness
  45. ```
  46. In the Codex IDE extension (gear menu → MCP servers) or the ChatGPT desktop app (Settings → MCP servers): **Add server → Streamable HTTP**, paste the URL, save, restart, and select **Authenticate**.
  47. ### VS Code
  48. Use the Add to VS Code button above. Or open the Command Palette, run **MCP: Add Server**, choose **HTTP**, and paste `https://mcp.phone-harness.com/mcp`. Sign in when asked.
  49. The same server in the VS Code `mcp.json` format:
  50. ```json
  51. {
  52. "servers": {
  53. "phone-harness": {
  54. "type": "http",
  55. "url": "https://mcp.phone-harness.com/mcp"
  56. }
  57. }
  58. }
  59. ```
  60. ### Windsurf
  61. **Settings → Tools → Windsurf Settings → Add Server**, or open the MCP config file from Cascade's MCP menu and add:
  62. ```json
  63. {
  64. "mcpServers": {
  65. "phone-harness": {
  66. "serverUrl": "https://mcp.phone-harness.com/mcp"
  67. }
  68. }
  69. }
  70. ```
  71. Cascade signs in with OAuth for a streamable HTTP server when no header is set. Press refresh after adding it.
  72. ### Devin
  73. In Devin, open **Customize → MCPs → Add MCP → Add custom MCP**. Set the transport to HTTP, the server URL to `https://mcp.phone-harness.com/mcp`, and authentication to OAuth. Save, then choose **Connect**. Adding a custom server needs the Manage MCP Servers permission.
  74. In the Devin CLI:
  75. ```bash
  76. devin mcp add phone-harness https://mcp.phone-harness.com/mcp
  77. devin mcp login phone-harness
  78. ```
  79. ### Gemini CLI
  80. ```bash
  81. gemini mcp add --transport http phone-harness https://mcp.phone-harness.com/mcp
  82. ```
  83. Gemini CLI discovers OAuth from the server. In a session, `/mcp auth phone-harness` starts the sign-in.
  84. ### GitHub Copilot
  85. ```bash
  86. copilot mcp add --transport http phone-harness https://mcp.phone-harness.com/mcp
  87. ```
  88. That writes a streamable HTTP server to `~/.copilot/mcp-config.json`. The default OAuth grant is the browser authorization-code flow.
  89. ### Perplexity
  90. Open **Plugins → Add custom → Add MCP connector**, and choose **Remote**. Name it, set the MCP server URL to `https://mcp.phone-harness.com/mcp`, and choose OAuth. For an organization, an admin adds it under **Organization settings → Connectors**.
  91. ### Warp
  92. **Warp Drive → MCP Servers → + Add**, choose Streamable HTTP, and set the URL to `https://mcp.phone-harness.com/mcp` with no headers. Warp’s docs show that a URL-only remote server opens a browser sign-in when it uses OAuth.
  93. ### Raycast
  94. Run **Install MCP Server**. Set the transport to HTTP, the URL to `https://mcp.phone-harness.com/mcp`, and OAuth to Dynamic. HTTP servers that use OAuth ask you to sign in before their tools are available.
  95. ### Manus
  96. Open **Connectors → Create → Add MCP by URL**. Enter a name and `https://mcp.phone-harness.com/mcp`.
  97. ### OpenClaw
  98. ```bash
  99. openclaw mcp add phone-harness --url https://mcp.phone-harness.com/mcp --transport streamable-http --auth oauth
  100. openclaw mcp login phone-harness
  101. ```
  102. Or in the Control UI: **Settings → MCP → Add server**, transport Streamable HTTP, then **Sign in**.
  103. ### Muse Code
  104. Add this to the `mcp_servers` block of the Muse Code settings file, then sign in:
  105. ```json
  106. {
  107. "mcp_servers": {
  108. "phone-harness": {
  109. "transport": "streamable_http",
  110. "url": "https://mcp.phone-harness.com/mcp"
  111. }
  112. }
  113. }
  114. ```
  115. ```bash
  116. muse mcp login phone-harness
  117. ```
  118. ### Zed
  119. **Settings → AI → MCP Servers → Add Server → Add Remote Server**, or add this to `settings.json`. With no `Authorization` header, Zed starts the MCP OAuth sign-in.
  120. ```json
  121. {
  122. "context_servers": {
  123. "phone-harness": {
  124. "url": "https://mcp.phone-harness.com/mcp"
  125. }
  126. }
  127. }
  128. ```
  129. ### Others
  130. Any other client that can add a remote streamable HTTP server uses the URL above and the sign-in. Local stdio, Docker, and Vercel are in [docs/self-hosting.md](docs/self-hosting.md).
  131. ## Tools
  132. The hosted server registers these tools. Every tool except the first two takes `device`, an id from `phone_list_available_devices`.
  133. Cloud Android emulators are free to start, then 5¢ per phone-minute, pay as you go. A Cloud iPhone is a flat monthly subscription, not billed by the minute: $80/mo, or $100/mo with an eSIM, with 20% off billed annually ($64/mo, or $80/mo with an eSIM). `minutes` on `phone_start_device` is how long the session runs (default 30), not a billing unit. See [phone-harness.com/pricing](https://phone-harness.com/pricing) for current rates.
  134. | Tool | Does |
  135. | --- | --- |
  136. | `phone_list_available_devices` | Running phones and their ids, the phones the account can start, and the account balance when the API reports one. |
  137. | `phone_start_device` | Start a phone and wait until it is ready. With nothing named, a temporary Android emulator starts. `platform` and `kind` go together (`android`/`emulator`, or `ios`/`device` for the account's iPhone). `device_id` picks a particular iPhone or a saved Android phone (apps and logins kept). |
  138. | `phone_stop_device` | End the session. Anything not saved on the phone is lost. Stopping cloud Android stops the per-minute charge. |
  139. | `phone_get_screen_size` | Screen size in the coordinate space taps and swipes use. |
  140. | `phone_take_screenshot` | JPEG of the screen. Long side at most `max_size` (default 1024), or `scale`. The text before the image converts a point in the image to screen coordinates. |
  141. | `phone_list_elements_on_screen` | Visible text with tap-ready centers (`text` or `json`). Accessibility tree on Android; text recognition on iPhone. |
  142. | `phone_click_on_screen_at_coordinates` | Tap `x`, `y`. |
  143. | `phone_long_press_on_screen_at_coordinates` | Press and hold `x`, `y` for `duration` milliseconds (default 800, clamped to 100–10000). |
  144. | `phone_swipe_on_screen` | Swipe. `direction` is the way the finger moves (`up` reveals what is below). From `x`, `y` or the center, for `distance` pixels or 40% of the screen. |
  145. | `phone_type_keys` | Type `text` into the focused field. `submit` presses Enter. |
  146. | `phone_press_button` | `HOME`, `BACK` (Android only), `APP_SWITCHER`, or `ENTER`. |
  147. | `phone_list_apps` | Installed apps: package ids on Android, bundle ids on an iPhone, when the phone can list them. |
  148. | `phone_launch_app` | Open an app by the name on its icon, or on Android by package id. |
  149. | `phone_get_foreground_app` | Which app is in front, when the phone reports it. |
  150. There is no tool that opens a URL. A local stdio server also registers `phone_save_screenshot` (write a PNG or JPEG on that machine). Tool names follow [mobile-mcp](https://github.com/mobile-next/mobile-mcp).
  151. ## FAQ
  152. ### Can I use an API key instead of signing in?
  153. Yes. Send `Authorization: Bearer pck_…` instead of going through OAuth. The buttons above do not include a key.
  154. ```json
  155. {
  156. "mcpServers": {
  157. "phone-harness": {
  158. "url": "https://mcp.phone-harness.com/mcp",
  159. "headers": { "Authorization": "Bearer pck_…" }
  160. }
  161. }
  162. }
  163. ```
  164. Codex reads the key from the environment:
  165. ```toml
  166. [mcp_servers.phone-harness]
  167. url = "https://mcp.phone-harness.com/mcp"
  168. bearer_token_env_var = "PHONE_HARNESS_API_KEY"
  169. ```
  170. Other API-key configs are in [docs/self-hosting.md](docs/self-hosting.md).
  171. ## Development
  172. ```bash
  173. uv sync
  174. uv run pytest
  175. uv run phone-harness-mcp --help
  176. ```
  177. Report vulnerabilities per [SECURITY.md](SECURITY.md).
  178. ## License
  179. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.