$git clone https://github.com/mobile-next/mobile-mcpThis is a Model Context Protocol (MCP) server that enables scalable mobile automation, development through a platform-agnostic interface, eliminating the need for distinct iOS or Android knowledge. You can run it on emulators, simulators
| 1 | # Mobile Next - MCP server for Mobile Development and Automation | iOS, Android, Simulator, Emulator, and Real Devices |
| 2 | |
| 3 | This is a [Model Context Protocol (MCP) server](https://github.com/modelcontextprotocol) that enables scalable mobile automation, development through a platform-agnostic interface, eliminating the need for distinct iOS or Android knowledge. You can run it on emulators, simulators, and real devices (iOS and Android). |
| 4 | This server allows Agents and LLMs to interact with native iOS/Android applications and devices through structured accessibility snapshots or coordinate-based taps based on screenshots. |
| 5 | |
| 6 | **Works with Claude Code, Codex, Gemini, GitHub Copilot, Antigravity** — or any MCP-compatible client. |
| 7 | |
| 8 | <h4 align="center"> |
| 9 | <a href="https://github.com/mobile-next/mobile-mcp"> |
| 10 | <img src="https://img.shields.io/github/stars/mobile-next/mobile-mcp" alt="Mobile Next Stars" /> |
| 11 | </a> |
| 12 | <a href="https://www.npmjs.com/package/@mobilenext/mobile-mcp"> |
| 13 | <img src="https://img.shields.io/npm/dm/@mobilenext/mobile-mcp?logo=npm&style=flat&color=red" alt="npm" /> |
| 14 | </a> |
| 15 | <a href="https://github.com/mobile-next/mobile-mcp/releases"> |
| 16 | <img src="https://img.shields.io/github/release/mobile-next/mobile-mcp" /> |
| 17 | </a> |
| 18 | <a href="https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22mobile-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40mobilenext%2Fmobile-mcp%40latest%22%5D%7D"> |
| 19 | <img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code" /> |
| 20 | </a> |
| 21 | <a href="https://github.com/mobile-next/mobile-mcp/wiki"> |
| 22 | <img src="https://img.shields.io/badge/documentation-wiki-blue" alt="wiki" /> |
| 23 | </a> |
| 24 | <a href="https://mobilenext.ai/join-slack"> |
| 25 | <img src="https://img.shields.io/badge/join-Slack-blueviolet?logo=slack&style=flat" alt="join on Slack" /> |
| 26 | </a> |
| 27 | </h4> |
| 28 | |
| 29 | |
| 30 | https://github.com/user-attachments/assets/bb084777-beb3-4930-ae6f-8d3fe694ddde |
| 31 | |
| 32 | |
| 33 | <p align="center"> |
| 34 | <a href="https://github.com/mobile-next/"> |
| 35 | <img alt="mobile-mcp" src="https://raw.githubusercontent.com/mobile-next/mobile-next-assets/refs/heads/main/mobile-mcp-banner.png" width="600" /> |
| 36 | </a> |
| 37 | </p> |
| 38 | |
| 39 | ### Main use cases |
| 40 | |
| 41 | How we help to scale mobile automation: |
| 42 | |
| 43 | - 📲 Native app automation (iOS and Android) for testing or data-entry scenarios. |
| 44 | - 📝 Scripted flows and form interactions without manually controlling simulators/emulators or real devices (iPhone, Samsung, Google Pixel etc) |
| 45 | - 🧭 Automating multi-step user journeys driven by an LLM |
| 46 | - 👆 General-purpose mobile application interaction for agent-based frameworks |
| 47 | - 🤖 Enables agent-to-agent communication for mobile automation usecases, data extraction |
| 48 | |
| 49 | ## Main Features |
| 50 | |
| 51 | - 🚀 **Accessibility-first — fast and cheap**: drives apps from the native accessibility tree (no vision model, no image tokens), falling back to screenshots + coordinates only when needed. |
| 52 | - 📱 **One API, every target**: the same tools work across iOS and Android — simulators, emulators, and real devices. |
| 53 | - 🧠 **No platform expertise required**: no XCUITest, no Espresso, no per-platform glue — describe the goal and the agent does it. |
| 54 | - 🧰 **Full device control**: taps, swipes, and gestures; app install/launch/terminate; screen recording; hardware buttons; deep links; orientation. |
| 55 | - 📊 **Structured, deterministic output**: reads real UI elements and extracts structured data, cutting the ambiguity of screenshot-only approaches. |
| 56 | |
| 57 | ### 🎯 Platform Support |
| 58 | |
| 59 | | Target | Supported | Setup | |
| 60 | |---|:---:|---| |
| 61 | | iOS Simulator | ✅ | Xcode + a booted simulator (`xcrun simctl`) | |
| 62 | | iOS Real Device | ✅ | go-ios + WebDriverAgent + tunnel | |
| 63 | | Android Emulator | ✅ | Android SDK + running emulator (`adb`) | |
| 64 | | Android Real Device | ✅ | `adb` + USB debugging enabled & authorized | |
| 65 | |
| 66 | ## 🔧 Available MCP Tools |
| 67 | |
| 68 | ### Device Management |
| 69 | - **`mobile_list_available_devices`** - List all available devices (simulators, emulators, |