R_REDDYX.XYZ
AgentsPython★ 807⑂ 70 forksMIT

phone-harness/mcp

MCP SERVER FOR CONTROLLING PHONES IN CLOUD

MCP server giving agents access to real iPhones and Android emulators in the cloud. The agent sees the screen, taps, types, swipes, and opens apps without local setup.

// KEY FEATURES

  • Connects to any MCP clients: Claude, Cursor, ChatGPT, Codex, VS Code
  • Real iPhones in cloud and Android emulators without local adb and Mac
  • Control like a human: screen, taps, text input, swipes, app launching
  • OAuth authentication with phone:drive scope or API key via Bearer token

// DEEP DIVE: HOW IT WORKS

Phone Harness MCP works as a remote MCP server via Streamable HTTP protocol. The client (Claude, Cursor, ChatGPT, etc.) connects to the endpoint https://mcp.phone-harness.com/mcp, completes OAuth with phone:drive scope or passes an API key, and receives a toolset for phone control: screen capture, taps, text input, swipes, app launching. No local environment required — no macOS, adb, or device pairing needed.

Difference from local solutions like Appium or scrcpy lies in complete hardware abstraction. Dedicated physical iPhones and Android emulators run in the cloud, controlled at the level of user actions rather than internal APIs. The server is implemented in Python and provides a unified interface for both platforms, hiding iOS code signing and Android debug bridge complexity.

Limitations: public internet access required for OAuth redirect and Streamable HTTP operation. For ChatGPT web, custom MCP servers are only available in Business, Enterprise, and Edu — Pro accounts can only read and fetch, not control the phone. Devin requires Manage MCP Servers permission. The server code itself is closed — this is a hosted service, not a self-hosted package.

// USE CASES

Best for: AI agent developers for testing and mobile app automation

  • Automate mobile app testing through agent natural language
  • Collect screenshot and action datasets for training multimodal models
  • Execute routine phone tasks: ride ordering, email checking, navigation

// QUICK START

claude mcp add --transport http phone-harness https://mcp.phone-harness.com/mcp
codex mcp add phone-harness --url https://mcp.phone-harness.com/mcp
codex mcp login phone-harness
grok mcp add --transport http phone-harness https://mcp.phone-harness.com/mcp

Commands are taken from the repository README — check the current version on GitHub before running.

#ai-agents#android#iphone#mcp#mcp-server#mobile-automation#model-context-protocol#phone-automation
Open on GitHub →

New repositories every 30 minutes

REDDYX AI scans GitHub 24/7 and ships the best AI/ML/Web3 projects to Telegram.

Join on Telegram
← Full catalog·Full index

// SIMILAR REPOSITORIES

ORG OS: CONTEXT, AGENTS, COLLABORATION★ 828MARKETING REVERSE ENGINEERING★ 72032 MARKETING SKILLS FOR AI AGENTS★ 698AGENT SKILL: HUMAN-LIKE TEXT REWRITING★ 659PLAYBOOK FOR BUILDING PROFITABLE AI APPS★ 651TIMON — AI AGENT ORCHESTRATOR ON LOCAL MACHINE★ 615

← FULL CATALOG

phone-harness/mcp — MCP Server For Controlling Phones IN Cloud