Home / MCP / Mobile Next MCP Server

Mobile Next MCP Server

Unified mobile automation server for iOS and Android with accessibility snapshots or coordinate-based actions.

typescript

2.6kstars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "mobile_mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@mobilenext/mobile-mcp@latest"
            ]
        }
    }
}

Mobile MCP Server provides a platform-agnostic interface to automate and develop for iOS and Android devices, including simulators, emulators, and real devices. It enables Agents and LLMs to interact with native apps and devices through accessibility data or coordinate-based actions, helping you create scalable mobile automation workflows without needing separate iOS or Android expertise.

How to use

After you add the MCP server to your IDE or client, you can instruct your AI assistant to use the available tools to validate UI interactions, read information from screen snapshots, and drive multi-step mobile journeys. You can run scripted flows for data entry, automate user journeys guided by an LLM, and enable agent-to-agent communication for mobile automation tasks.

How to install

Prerequisites you need before starting Mobile MCP Server:

Node.js v22+
npm or npx (comes with Node.js)
Xcode command line tools (macOS) for iOS tooling
Android Platform Tools (SDK) for Android tooling

Install and run the MCP server using the standard configuration provided in the example below. This config uses npx to fetch the Mobile MCP package and run it directly.

{
  "mcpServers": {
    "mobile-mcp": {
      "command": "npx",
      "args": ["-y", "@mobilenext/mobile-mcp@latest"]
    }
  }
}

Available tools

mobile_list_available_devices

List all available devices, including simulators, emulators, and real devices, to understand what you can connect to.

mobile_get_screen_size

Return the screen width and height in pixels for the current device.

mobile_get_orientation

Get the current screen orientation (portrait or landscape) of the device.

mobile_set_orientation

Change the device orientation to portrait or landscape.

mobile_list_apps

List all installed apps on the connected device.

mobile_launch_app

Launch a specific app using its package or bundle identifier.

mobile_terminate_app

Terminate a running app on the device.

mobile_install_app

Install an app from a file (APK, IPA, app, or zip).

mobile_uninstall_app

Uninstall an app by package name or bundle ID.

mobile_take_screenshot

Capture a screenshot of the current device screen.

mobile_save_screenshot

Save the current screen image to a file for later analysis.

mobile_list_elements_on_screen

Enumerate visible UI elements with coordinates and properties.

mobile_click_on_screen_at_coordinates

Tap at specific x,y coordinates on the screen.

mobile_double_tap_on_screen

Perform a double-tap at given coordinates.

mobile_long_press_on_screen_at_coordinates

Long-press at specific coordinates.

mobile_swipe_on_screen

Swipe in a given direction (up, down, left, right) across the screen.

mobile_type_keys

Type text into the focused element, with optional submit action.

mobile_press_button

Press device hardware buttons (HOME, BACK, VOLUME_UP/DOWN, ENTER, etc.).

mobile_open_url

Open a URL in the device browser.