MCP server for iOS and Android Mobile Development, Automation and Testing
The MCP server for iOS and Android mobile development, automation, and testing exposes a platform-agnostic interface to interact with native apps and devices. It supports emulators, simulators, and real devices, enabling scalable mobile automation and development without requiring separate iOS or Android expertise.
🛠️ Key Features
Platform-agnostic Model Context Protocol (MCP) server for mobile
Supports iOS and Android devices, both real and simulated
Enables automation, testing, and development through structured snapshots and coordinate-based interactions
Runs on emulators, simulators, and physical devices
🚀 Use Cases
Mobile application automation and testing across platforms
Device-agnostic development workflows for iOS and Android
Interaction with native apps via accessibility snapshots and coordinate taps
Scalable integration for Agents and LLMs
⚡ Developer Benefits
Unified interface for iOS/Android with no platform-specific knowledge required
Easy integration with mobile emulators, simulators, and real devices
Compatibility with platform-agnostic tooling and workflows
⚠️ Limitations
Specific device capabilities may vary by platform and environment
Requires support from connected devices or simulators for full interaction
Documentation references may depend on the MCP ecosystem and setup
Mobile Next - MCP server for Mobile Development and Automation | iOS, Android, Simulator, Emulator, and Real Devices
This 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, and real devices (iOS and Android).
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.
Works with Claude Code, Codex, Gemini, GitHub Copilot, Antigravity — or any MCP-compatible client.
📲 Native app automation (iOS and Android) for testing or data-entry scenarios.
📝 Scripted flows and form interactions without manually controlling simulators/emulators or real devices (iPhone, Samsung, Google Pixel etc)
🧭 Automating multi-step user journeys driven by an LLM
👆 General-purpose mobile application interaction for agent-based frameworks
🤖 Enables agent-to-agent communication for mobile automation usecases, data extraction
Main Features
🚀 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.
📱 One API, every target: the same tools work across iOS and Android — simulators, emulators, and real devices.
🧠 No platform expertise required: no XCUITest, no Espresso, no per-platform glue — describe the goal and the agent does it.
🧰 Full device control: taps, swipes, and gestures; app install/launch/terminate; screen recording; hardware buttons; deep links; orientation.
📊 Structured, deterministic output: reads real UI elements and extracts structured data, cutting the ambiguity of screenshot-only approaches.
🎯 Platform Support
Target
Supported
Setup
iOS Simulator
✅
Xcode + a booted simulator (xcrun simctl)
iOS Real Device
✅
go-ios + WebDriverAgent + tunnel
Android Emulator
✅
Android SDK + running emulator (adb)
Android Real Device
✅
adb + USB debugging enabled & authorized
🔧 Available MCP Tools
Device Management
mobile_list_available_devices - List all available devices (simulators, emulators, and real devices)
mobile_get_screen_size - Get the screen size of the mobile device in pixels
mobile_get_orientation - Get the current screen orientation of the device
mobile_set_orientation - Change the screen orientation (portrait/landscape)
App Management
mobile_list_apps - List all installed apps on the device
mobile_launch_app - Launch an app using its package name
mobile_terminate_app - Stop and terminate a running app
mobile_install_app - Install an app from file (.apk, .ipa, .app, .zip)
mobile_uninstall_app - Uninstall an app using bundle ID or package name
Screen Interaction
mobile_take_screenshot - Take a screenshot to understand what's on screen
mobile_save_screenshot - Save a screenshot to a file
mobile_list_elements_on_screen - List UI elements with their coordinates and properties
mobile_click_on_screen_at_coordinates - Click at specific x,y coordinates
mobile_double_tap_on_screen - Double-tap at specific coordinates
mobile_long_press_on_screen_at_coordinates - Long press at specific coordinates
mobile_swipe_on_screen - Swipe in any direction (up, down, left, right)
mobile_start_screen_recording - Start recording the device screen to a video file
mobile_stop_screen_recording - Stop the active screen recording and save the video
Input & Navigation
mobile_type_keys - Type text into focused elements with optional submit
For iOS real devices (simulators and Android don't need these), you'll also need go-ios, WebDriverAgent installed on the device, and an iOS device tunnel. See the wiki for setup.
For more information, see the Copilot CLI documentation.
Cursor
Click the button to install:
Or install manually:
Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command npx -y @mobilenext/mobile-mcp@latest. You can also verify config or add command like arguments via clicking Edit.
Go to Advanced settings -> Extensions -> Add custom extension. Name to your liking, use type STDIO, and set the command to npx -y @mobilenext/mobile-mcp@latest. Click "Add Extension".
Kiro
Follow the MCP Servers documentation. For example in .kiro/settings/mcp.json:
Once the server is configured, ask your agent to list devices:
list available devices
You should get back your running simulators, emulators, and connected devices. If you do, Mobile MCP is wired up correctly. If the list is empty, make sure a simulator or emulator is running (see Prerequisites) — for more help, check the wiki.
SSE Server Mode
By default, Mobile MCP runs over stdio. To start an SSE server instead, use the --listen flag:
bash
npx @mobilenext/mobile-mcp@latest --listen 3000
This binds to localhost:3000. To bind to a specific interface:
When set, all requests must include the header Authorization: Bearer my-secret-token.
🛠️ How to Use 📝
After adding the MCP server to your IDE/Client, you can instruct your AI assistant to use the available tools.
For example, in Cursor's agent mode, you could use the prompts below to quickly validate, test and iterate on UI interactions, read information from screen, go through complex workflows.
Be descriptive, straight to the point.
✨ Example Prompts
Workflows
You can specify detailed workflows in a single prompt, verify business logic, setup automations. You can go crazy:
Search for a video, comment, like and share it.
code
Find the video called " Beginner Recipe for Tonkotsu Ramen" by Way of
Ramen, click on like video, after liking write a comment " this was
delicious, will make it next Friday", share the video with the first
contact in your whatsapp list.
Download a successful step counter app, register, setup workout and 5-star the app
code
Find and Download a free "Pomodoro" app that has more than 1k stars.
Launch the app, register with my email, after registration find how to
start a pomodoro timer. When the pomodoro timer started, go back to the
app store and rate the app 5 stars, and leave a comment how useful the
app is.
Search in Substack, read, highlight, comment and save an article
code
Open Substack website, search for "Latest trends in AI automation 2025",
open the first article, highlight the section titled "Emerging AI trends",
and save article to reading list for later review, comment a random
paragraph summary.
Reserve a workout class, set timer
code
Open ClassPass, search for yoga classes tomorrow morning within 2 miles,
book the highest-rated class at 7 AM, confirm reservation,
setup a timer for the booked slot in the phone
Find a local event, setup calendar event
code
Open Eventbrite, search for AI startup meetup events happening this
weekend in "Austin, TX", select the most popular one, register and RSVP
yes to the event, setup a calendar event as a reminder.
Check weather forecast and send a Whatsapp/Telegram/Slack message
code
Open Weather app, check tomorrow's weather forecast for "Berlin", and
send the summary via Whatsapp/Telegram/Slack to contact "Lauren Trown",
thumbs up their response.
Schedule a meeting in Zoom and share invite via email
code
Open Zoom app, schedule a meeting titled "AI Hackathon" for tomorrow at
10AM with a duration of 1 hour, copy the invitation link, and send it via
Gmail to contacts "team@example.com".
Running in "headless" mode on Simulators/Emulators
When you do not have a real device connected to your machine, you can run Mobile MCP with an emulator or simulator in the background.
For example, on Android:
Start an emulator (avdmanager / emulator command).
Run Mobile MCP with the desired flags
On iOS, you'll need Xcode and to run the Simulator before using Mobile MCP with that simulator instance.
xcrun simctl list
xcrun simctl boot "iPhone 16"
🧩 Part of Mobile Next
Mobile MCP is one piece of a toolkit for driving real mobile devices:
mobilewright — "Playwright for mobile." When you're ready to turn agent-driven exploration into repeatable, deterministic tests for iOS and Android, graduate to mobilewright.
mobilecli — the universal device CLI that Mobile MCP is built on: control devices, simulators, and emulators from the command line or a JSON-RPC API.
Mobile Next Cloud — run all of it against real iOS and Android devices in the cloud, on demand.
🚀 Roadmap
We're continuously improving Mobile MCP. See what we're building next in ROADMAP.md — priorities are shaped heavily by community feedback, so tell us what you'd like to see.
🤝 Contributing
Contributions are welcome — code, docs, bug reports, and ideas.
⭐ Star the repo — the easiest way to help others discover Mobile MCP.
Read CONTRIBUTING.md for how to build, test, and open a pull request.
