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
{
"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-mcpCursor
{
"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
{
"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_devicesRunning phones and their ids, the phones the account can start, and the account balance when the API reports one.
phone_start_deviceStart a phone and wait until it is ready. With nothing named, a temporary Android emulator starts.
phone_stop_deviceEnd the session. Anything not saved on the phone is lost. Stopping cloud Android stops the per-minute charge.
phone_get_screen_sizeScreen size in the coordinate space taps and swipes use.
phone_take_screenshotJPEG of the screen. Long side at most maxsize (default 1024), or scale.
phone_list_elements_on_screenVisible text with tap-ready centers (text or json). Accessibility tree on Android; text recognition on iPhone.
phone_click_on_screen_at_coordinatesTap x, y.
phone_long_press_on_screen_at_coordinatesPress and hold x, y for duration milliseconds (default 800, clamped to 100–10000).
phone_swipe_on_screenSwipe. direction is the way the finger moves (up reveals what is below).
phone_type_keysType text into the focused field. submit presses Enter.
phone_press_buttonHOME, BACK (Android only), APPSWITCHER, or ENTER.
phone_list_appsInstalled apps: package ids on Android, bundle ids on an iPhone, when the phone can list them.
phone_launch_appOpen an app by the name on its icon, or on Android by package id.
phone_get_foreground_appWhich 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
Similar MCP servers
More developer tools MCP servers
Idea Reality MCP
mnemox-ai/idea-reality-mcp
Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.
Maintained · last commit Sep 18, 2026
Developer toolsPythonOrcareplay
Continuum-AI-Corp/OrcaReplay
Read, replay and fork recorded coding-agent runs.
Too new to judge · created Aug 29, 2026
OfficialDeveloper toolsTypeScriptCodeman
Ark0N/Codeman
Start, prompt and read AI coding agent sessions (Claude Code, Codex, Gemini CLI and more) in Codeman.
Active · last commit Nov 13, 2026
Developer toolsTypeScriptAnythingMCP
HelpCode-ai/anythingmcp
MCP gateway and company brain: 732 connectors (SAP, ERP, SQL), file search, memory and skills.
Active · last commit Nov 16, 2026
Developer toolsTypeScriptProjectmem
riponcm/projectmem
Coding agent memory — one local MCP server for every project.
Active · last commit Nov 1, 2026
Developer toolsPythonAwwwards MCP
INSANE0777/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…
Too new to judge · created Sep 18, 2026
Developer toolsTypeScript
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.