Mobile Next Mobile MCP for Cursor: Setup & Config

What you can do with Mobile Next Mobile in Cursor

Pick it for one accessibility-first MCP interface across native iOS and Android device workflows.

• Capture screenshots, screen recordings, and crash information.
• Extract structured information from visible app screens.

Before you start: Mobile Next Mobile in Cursor

• Node.js 22 or newer
• An MCP-capable client or agent
• Configured mobile platform SDKs and tools
• Xcode command-line tools for iOS workflows
• Android Platform Tools for Android workflows
• A connected device or running simulator/emulator

Stdio is the default. A --listen mode is documented with optional MOBILEMCP_AUTH bearer authentication. Set MOBILEMCP_DISABLE_TELEMETRY=1 to opt out of anonymous usage telemetry.

Mobile Next Mobile Cursor configuration

1. Choose Cursor configuration scope

   For Mobile Next Mobile MCP, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

2. Add Mobile Next Mobile MCP to Cursor

   Use the mobile-mcp entry below in mcpServers. Keep Mobile Next Mobile MCP's documented stdio connection fields and your other Cursor entries.

3. Check Mobile Next Mobile MCP in Cursor

   Mobile Next Mobile MCP: Enable in Cursor’s MCP settings; inspect tools.

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

Mobile Next Mobile tools available to Cursor

Mobile Next Mobile's stored tool list documents 27 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

mobile_list_available_devices

Find mobile_list_available_devices under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Find locally connected phones, tablets, simulators, and emulators.

mobile_login_to_cloud_provider

Find mobile_login_to_cloud_provider under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_list_remote_devices

Find mobile_list_remote_devices under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_allocate_remote_device

Find mobile_allocate_remote_device under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_release_remote_device

Find mobile_release_remote_device under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_list_apps

Find mobile_list_apps under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_launch_app

Find mobile_launch_app under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_terminate_app

Find mobile_terminate_app under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_install_app

Find mobile_install_app under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_uninstall_app

Find mobile_uninstall_app under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_get_screen_size

Find mobile_get_screen_size under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_click_on_screen_at_coordinates

Find mobile_click_on_screen_at_coordinates under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_double_tap_on_screen

Find mobile_double_tap_on_screen under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_long_press_on_screen_at_coordinates

Find mobile_long_press_on_screen_at_coordinates under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

mobile_list_elements_on_screen

Find mobile_list_elements_on_screen under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect current UI elements, labels, and coordinates without caching results.

mobile_press_button

Find mobile_press_button under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Trigger a device button action.

mobile_open_url

Find mobile_open_url under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Navigate to a URL in the device browser.

mobile_swipe_on_screen

Find mobile_swipe_on_screen under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Perform a swipe gesture.

mobile_type_keys

Find mobile_type_keys under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Enter text in the currently focused field.

mobile_save_screenshot

Find mobile_save_screenshot under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Write a device screenshot to a file.

mobile_take_screenshot

Find mobile_take_screenshot under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Capture the current screen for visual inspection without caching it.

mobile_set_orientation

Find mobile_set_orientation under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Switch the device screen orientation.

mobile_get_orientation

Find mobile_get_orientation under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Read the device screen orientation.

mobile_start_screen_recording

Find mobile_start_screen_recording under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Begin background screen capture and report the output path.

mobile_stop_screen_recording

Find mobile_stop_screen_recording under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

End screen capture and report its path, size, and approximate duration.

mobile_list_crashes

Find mobile_list_crashes under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Find crash reports stored on the device.

mobile_get_crash

Find mobile_get_crash under Mobile Next Mobile in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Read a crash report using an identifier from the crash list.

Mobile Next Mobile: full stored tool descriptions

Troubleshooting Mobile Next Mobile in Cursor

• Cursor must find npx @mobilenext/mobile-mcp@latest (Node.js/npm) for Mobile Next Mobile MCP. Enable the project/user entry in MCP settings and inspect its tools.
• Mobile Next Mobile MCP uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires platform SDKs, tools, and correctly configured devices.
• Known limitation: Anonymous telemetry is collected unless disabled.
• Known limitation: Remote cloud reservations are billed, and releasing them loses device changes.
• General Cursor troubleshooting lives in the /clients/cursor guide.

Frequently asked questions