Mobile MCP
An MCP server to drive iOS and Android: simulators, emulators and real devices via accessibility trees and screenshots
Install
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latestThis is third-party code. Review the repository files before installing.
What it does
The server gives the agent one toolset for iOS and Android with no XCUITest or Espresso knowledge required. The agent reads screen elements from the accessibility tree and falls back to screenshots and coordinates only when needed. It covers taps, swipes, text input, hardware buttons, app install and launch, screen recording, device logs and crash reports. Several actions can run in one call, and Mobile Next Cloud devices can be attached if needed.
Who it is for. For mobile developers and testers who want the agent to walk through app scenarios on its own.
Good fit when
- You need to check a user flow in your app on a simulator
- You need logs and a crash report after reproducing a bug
- You need to automate data entry in a native app
Not a fit when
- You need repeatable deterministic CI tests: the authors point to mobilewright
- Xcode or the Android SDK is not installed
Example request
Launch my app on the iPhone simulator, go through sign-up and send me the logs if it crashesLimitations
Requires Node 20 or newer, Xcode command line tools and Android Platform Tools. iOS simulators need macOS. The server sends anonymous telemetry, disabled via MOBILEMCP_DISABLE_TELEMETRY. Cloud devices require a Mobile Next account.
How to disable. Run claude mcp remove mobile-mcp or delete the mobile-mcp block from the MCP config.
MCP
- Transport
- stdio, http
- Authentication
- not required
| Environment variables | |
|---|---|
| MOBILEMCP_AUTH secret | Bearer token for HTTP mode |
| MOBILEMCP_DISABLE_TELEMETRY | Disables anonymous telemetry |
| MOBILEMCP_ALLOW_UNSAFE_URLS | Allows opening non-standard URL schemes |
Security check
- Controls the device: installs and removes apps, types text
- On a real device the agent can reach personal data and accounts
README in short
The README lists supported platforms and all tools by group: devices, apps, screen, input, logs and cloud. It gives configs for Claude Code, Codex, Cursor, Gemini CLI, Copilot, Goose, opencode, Amp and other clients. It covers HTTP mode with auth, environment variables, telemetry and running against simulators without a device. Apache 2.0 licensed.
FAQ
Do I need a vision model?
Not necessarily: the main mode works from the accessibility tree, screenshots are a fallback.
Can it run over HTTP?
Yes, the --listen flag starts Streamable HTTP, and MOBILEMCP_AUTH enables Bearer token checks.
Related
An MCP server and CLI from Sentry for building, running and testing Xcode iOS and macOS projects from an AI agent
Paul Hudson's skill for reviewing and writing SwiftUI for iOS 26: deprecated APIs, data flow, navigation, accessibility, performance
Expo's official agent skills: building, deploying, updating and debugging Expo and EAS apps
An open phone agent model and framework: it reads the screen and taps through Android, HarmonyOS and iOS apps from a text command