Home / MCP / Mobile MCP Server

Mobile MCP Server

Provides a unified API to automate native iOS/Android apps and devices via structured accessibility data or coordinate-based interactions.

typescript

3.1kstars

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 Next MCP Server provides a unified interface to automate native iOS and Android apps and devices, enabling scalable mobile automation across simulators, emulators, and real devices with a platform-agnostic API.

How to use

You connect your MCP client or AI assistant to the Mobile Next MCP Server to automate native mobile apps and device interactions. Use the available MCP tools to list devices, launch and manage apps, take and save screenshots, interact with on-screen elements by coordinates, and simulate user actions like taps, swipes, and text entry. The server is designed to work across iOS and Android, providing a consistent workflow for testing, data entry, and complex multi-step journeys driven by an LLM.

How to install

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

Additional notes

Prerequisites include development toolchains and runtimes to connect to iOS and Android devices. Ensure you have Xcode command line tools, Android Platform Tools, and a recent Node.js installation. The server can run in headless mode on simulators or emulators when no real device is connected.

Available tools

mobile_list_available_devices

List all available devices including simulators, emulators, and real devices.

mobile_get_screen_size

Return the screen size in pixels for the connected device.

mobile_get_orientation

Return the current screen orientation (portrait or landscape).

mobile_set_orientation

Set the device orientation to portrait or landscape.

mobile_list_apps

List all installed apps on the target device.

mobile_launch_app

Launch an app by its package name.

mobile_terminate_app

Terminate a running app on the device.

mobile_install_app

Install an app from a file (apk/ipa/app/zip).

mobile_uninstall_app

Uninstall an app by bundle ID or package name.

mobile_take_screenshot

Capture a screenshot of the current screen.

mobile_save_screenshot

Save a screenshot to a file for later inspection.

mobile_list_elements_on_screen

Enumerate UI elements on screen with coordinates and properties.

mobile_click_on_screen_at_coordinates

Click at a specific x,y coordinate 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 direction (up, down, left, right) across the screen.

mobile_type_keys

Type text into the focused element with optional submit behavior.

mobile_press_button

Press device buttons such as HOME, BACK, VOLUME_UP/DOWN, ENTER, etc.

mobile_open_url

Open a URL in the device browser.