mobile-next/mobile-mcp

Mobile Next - MCP server for Mobile Development and Automation | iOS, Android, Simulator, Emulator, and Real Devices English | 日本語 | 簡體中文 This is an 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. Run it against devices on your own machine, or against real iOS and Android devices in the cloud with Mobile Next Cloud — same tools, no local setup. mobile-next-mcp-video.mp4 Main use cases How we help to scale mobile automation: 📲 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 ✅ Device connected over USB and trusted 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) mobile_set_location - Override the GPS location reported by the device, or clear the override mobile_clipboard - Read or replace the device clipboard Remote Devices (Mobile Next Cloud) mobile_login_to_cloud_provider - Authenticate this machine with the cloud device provider (browser-based device-code login) mobile_list_remote_devices - List device models available to reserve from the cloud fleet mobile_allocate_remote_device - Reserve a physical cloud device for exclusive use mobile_release_remote_device - Release a reserved cloud device back to the fleet App Management mobile_list_apps - List all installed apps on the device mobile_get_foreground_app - Get the app currently in the foreground 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 mobile_press_button - Press device buttons (HOME, BACK, VOLUME_UP/DOWN, ENTER, etc.) mobile_open_url - Open URLs in the device browser Logs & Crash Reports mobile_get_device_logs - Collect live device logs (logcat on Android, unified log on iOS), optionally saved to a file mobile_list_crashes - List crash reports available on the device mobile_get_crash - Get the full content of a crash report by its ID mobile_batch_commands - Run multiple tools in sequence in a single call (e.g. click, type, click), optionally listing screen elements at the end 🏗️ Mobile MCP Architecture 📚 Wiki page More details in our wiki page for setup, configuration and debugging related questions. Prerequisites What you will need to connect MCP with your agent and mobile devices: Xcode command line tools Android Platform Tools node.js v20+ MCP supported foundational models or agents, like Claude MCP , OpenAI Agent SDK , Copilot Studio Installation and configuration Standard config works in most of the tools: { "mcpServers" : { "mobile-mcp" : { "command" : " npx " , "args" : [ " -y " , " @mobilenext/mobile-mcp@latest " ] } } } Amp Add via the Amp VS Code extension settings screen or by updating your settings.json file: "amp.mcpServers" : { "mobile-mcp" : { "command" : " npx " , "args" : [ " @mobilenext/mobile-mcp@latest " ] } } Amp CLI: Run the following command in your terminal: amp mcp add mobile-mcp -- npx @mobilenext/mobile-mcp@latest Antigravity 2 Antigravity doesn't have a CLI command to add MCP servers, so add it manually. Edit ~/.gemini/config/mcp_config.json and add: { "mcpServers" : { "mobile-mcp" : { "command" : " npx " , "args" : [ " -y " , " @mobilenext/mobile-mcp@latest " ] } } } Cline To setup Cline, just add the json above to your MCP settings file. More in our wiki Claude Code Use the Claude Code CLI to add the Mobile MCP server: claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest Claude Desktop Follow the MCP install guide , use json configuration above. Codex Use the Codex CLI to add the Mobile MCP server: codex mcp add mobile-mcp npx " @mobilenext/mobile-mcp@latest " Alternatively, create or edit the configuration file ~/.codex/config.toml and add: [ mcp_servers . mobile-mcp ] command = " npx " args = [ " @mobilenext/mobile-mcp@latest " ] For more information, see the Codex MCP documentation. Copilot Use the Copilot CLI to interactively add the Mobile MCP server: /mcp add You can edit the configuration file ~/.copilot/mcp-config.json and add: { "mcpServers" : { "mobile-mcp" : { "type" : " local " , "command" : " npx " , "tools" : [ " * " ], "args" : [ " @mobilenext/mobile-mcp@latest " ] } } } 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 . Gemini CLI Use the Gemini CLI to add the Mobile MCP server: gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp@latest Goose Click the button to install: Or install manually: 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.