#8383rd of 155 in MCP servers for developers
phone-harness
CLI that lets coding agents tap, type and read a real iPhone or Android
- Stars
- 5.1k
- License
- MIT
- Last commit
- Nov 2026
- Last release
- Nov 2026
- Language
- Python
37 on 5 Aug 20265,137 on 18 Nov 2026
From GitHub's daily star counts.
Checked on GitHub.
Overview
phone-harness is a Python CLI with pre-imported helpers (open_app, tap_text, type_text, screen, screenshot) that agents call to drive a phone. iPhone control goes through the Mac's iPhone Mirroring window with Apple Vision OCR; Android uses adb and the accessibility tree. A hosted cloud service adds remote Androids and iPhones, and a hosted MCP endpoint plus Hermes and OpenClaw plugins are provided.
Who it is for: Developers wiring coding agents to real phones for app automation
Strengths
- Nothing installed on the phone: no jailbreak, no Xcode
- Same helper API across iPhone, Android and cloud phones
- Android works from macOS, Linux or Windows over USB or Wi-Fi
- Ships a skill, hosted MCP endpoint, and Hermes and OpenClaw plugins
Weaknesses
- Local iPhone control needs macOS 15+ and iPhone Mirroring paired to iOS 18+
- OCR reads text only; unlabeled icons need a screenshot and vision model
- No multi-touch, camera or Face ID flows; DRM video renders black
- Hosted MCP supports only cloud phones, which need a Phone Harness Cloud account
What it needs
- no GPU
- Needs adb, uv, Python 3.12, macOS 15+ with iPhone Mirroring (iPhone), Phone Harness Cloud account (cloud phones)
- Models: Claude Code, Codex, any MCP client
What changed
From the release notes. No flag means the note does not say so, not that the upgrade is safe.
Known problems
Open now, reported in the last 90 days
Reported, then fixed by a linked change
- Vision OCR crashes on macOS with empty options dict ↗ (opens in a new tab)0 reactions · closed 3 Nov 2026Fixed by fix(ocr): pass None instead of empty dict to VNImageRequestHandler options (#178) ↗ (opens in a new tab)
- Fresh install broken on pyobjc >= 12: bad AppKit dep name + VNImageRequestHandler options={} raises ↗ (opens in a new tab)0 reactions · closed 29 Aug 2026Fixed by fix(scroll): background scroll tapped rows instead of scrolling ↗ (opens in a new tab)
Titles are the reporters' own words, taken from the project's GitHub issues and ranked by reactions. We have not tried to reproduce any of them.
Also in MCP servers for developers
See all 155| Rank | Project | Score |
|---|---|---|
| 1 | codegraphLocal code knowledge graph that coding agents query over MCP | 97 out of 100 |
| 2 | gitnexusCode knowledge graph exposed to coding agents through MCP tools | 97 out of 100 |
| 3 | playwright-mcpMCP server that lets LLMs drive a browser through Playwright accessibility snapshots | 93 out of 100 |
| #4 | code-review-graphLocal Tree-sitter code graph that gives coding assistants review context over MCP | 92 out of 100 |
| #5 | serenaMCP server giving coding agents symbol-level code search, editing and refactoring | 92 out of 100 |