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](https://mobilenext.ai/cloud?utm_source=github&utm_medium=readme&utm_campaign=mobile-mcp&utm_content=intro) — same tools, no local setup.

https://github.com/user-attachments/assets/bb084777-beb3-4930-ae6f-8d3fe694ddde

🚀 Quick start

Quick install detects the MCP clients on this machine (Claude Code, Codex, Cursor, VS Code, Gemini CLI and more) and lets you pick which ones to configure:

npx @mobilenext/mobile-mcp@latest install

Add --yes to configure every detected client without asking.

Manual setup per client: Installation and configuration

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.
• 🪞 Device mirroring in Claude Code: for Claude Code running in Ghostty or kitty. Install the plugin and run /mobile-mirror to see the device's live screen in a side pane, then tap, type and press Home/Back without leaving the terminal.

🎯 Platform Support

🔧 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_fold_device` - Fold or unfold a foldable device (iPhone Duo simulators, foldable Android emulators)
• `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 by its package name or bundle ID
• `mobile_clear_app_data` - Clear an app's data so it starts fresh (Android and iOS Simulator)

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 or on an element by its ref
• `mobile_double_tap_on_screen` - Double-tap at specific coordinates or on an element by its ref
• `mobile_long_press_on_screen_at_coordinates` - Long press at specific coordinates or on an element by its ref
• `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 http/https 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

To configure it by hand, this 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

Install the plugin from inside Claude Code. It adds the Mobile MCP server and /mobile-mirror:

/plugin marketplace add mobile-next/mobile-mcp

/plugin install mobile-mcp@mobile-mcp

/mobile-mirror [device-id] opens a pane with the device's live screen. Click the picture to tap, type to send keys, and use the Home, Back, App Switch and URL buttons above it. The picture needs a terminal with the kitty graphics protocol, such as kitty or Ghostty.

If you can't use plugins, add only the MCP server with the Claude Code CLI:

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest

Claude Desktop

Follow the [MCP install guide](https://modelcontextprotocol.io/q