Mobile Next Mobile MCP for Claude Code: Setup & Config

What you can do with Mobile Next Mobile in Claude Code

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

• Test native app flows across Android and iOS.
• Extract structured information from visible app screens.

Before you start: Mobile Next Mobile in Claude Code

• 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 Claude Code configuration

1. Choose Claude Code configuration scope

   For Mobile Next Mobile MCP, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

2. Add Mobile Next Mobile MCP to Claude Code

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

3. Check Mobile Next Mobile MCP in Claude Code

   Mobile Next Mobile MCP: Inspect claude mcp list and /mcp status.

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

claude mcp add-json --scope project 'mobile-mcp' '{"type":"stdio","command":"npx","args":["-y","@mobilenext/mobile-mcp@latest"],"env":{}}'

Mobile Next Mobile tools available to Claude Code

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

mobile_list_available_devices

For Mobile Next Mobile's mobile_list_available_devices, review the permission request and arguments in Claude Code before approval.

mobile_login_to_cloud_provider

For Mobile Next Mobile's mobile_login_to_cloud_provider, review the permission request and arguments in Claude Code before approval.

mobile_list_remote_devices

For Mobile Next Mobile's mobile_list_remote_devices, review the permission request and arguments in Claude Code before approval.

Browse device models available in the cloud fleet.

mobile_allocate_remote_device

For Mobile Next Mobile's mobile_allocate_remote_device, review the permission request and arguments in Claude Code before approval.

Reserve a billed cloud device for exclusive use after explicit user approval.

mobile_release_remote_device

For Mobile Next Mobile's mobile_release_remote_device, review the permission request and arguments in Claude Code before approval.

Return a reserved cloud device and discard changes made during the session.

mobile_list_apps

For Mobile Next Mobile's mobile_list_apps, review the permission request and arguments in Claude Code before approval.

Enumerate applications installed on a device.

mobile_launch_app

For Mobile Next Mobile's mobile_launch_app, review the permission request and arguments in Claude Code before approval.

Start an application on the selected device.

mobile_terminate_app

For Mobile Next Mobile's mobile_terminate_app, review the permission request and arguments in Claude Code before approval.

Stop a running mobile application.

mobile_install_app

For Mobile Next Mobile's mobile_install_app, review the permission request and arguments in Claude Code before approval.

Add an application to a device.

mobile_uninstall_app

For Mobile Next Mobile's mobile_uninstall_app, review the permission request and arguments in Claude Code before approval.

mobile_get_screen_size

For Mobile Next Mobile's mobile_get_screen_size, review the permission request and arguments in Claude Code before approval.

mobile_click_on_screen_at_coordinates

For Mobile Next Mobile's mobile_click_on_screen_at_coordinates, review the permission request and arguments in Claude Code before approval.

mobile_double_tap_on_screen

For Mobile Next Mobile's mobile_double_tap_on_screen, review the permission request and arguments in Claude Code before approval.

mobile_long_press_on_screen_at_coordinates

For Mobile Next Mobile's mobile_long_press_on_screen_at_coordinates, review the permission request and arguments in Claude Code before approval.

mobile_list_elements_on_screen

For Mobile Next Mobile's mobile_list_elements_on_screen, review the permission request and arguments in Claude Code before approval.

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

mobile_press_button

For Mobile Next Mobile's mobile_press_button, review the permission request and arguments in Claude Code before approval.

mobile_open_url

For Mobile Next Mobile's mobile_open_url, review the permission request and arguments in Claude Code before approval.

mobile_swipe_on_screen

For Mobile Next Mobile's mobile_swipe_on_screen, review the permission request and arguments in Claude Code before approval.

mobile_type_keys

For Mobile Next Mobile's mobile_type_keys, review the permission request and arguments in Claude Code before approval.

mobile_save_screenshot

For Mobile Next Mobile's mobile_save_screenshot, review the permission request and arguments in Claude Code before approval.

mobile_take_screenshot

For Mobile Next Mobile's mobile_take_screenshot, review the permission request and arguments in Claude Code before approval.

mobile_set_orientation

For Mobile Next Mobile's mobile_set_orientation, review the permission request and arguments in Claude Code before approval.

Switch the device screen orientation.

mobile_get_orientation

For Mobile Next Mobile's mobile_get_orientation, review the permission request and arguments in Claude Code before approval.

Read the device screen orientation.

mobile_start_screen_recording

For Mobile Next Mobile's mobile_start_screen_recording, review the permission request and arguments in Claude Code before approval.

Begin background screen capture and report the output path.

mobile_stop_screen_recording

For Mobile Next Mobile's mobile_stop_screen_recording, review the permission request and arguments in Claude Code before approval.

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

mobile_list_crashes

For Mobile Next Mobile's mobile_list_crashes, review the permission request and arguments in Claude Code before approval.

Find crash reports stored on the device.

mobile_get_crash

For Mobile Next Mobile's mobile_get_crash, review the permission request and arguments in Claude Code before approval.

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

Mobile Next Mobile: full stored tool descriptions

Troubleshooting Mobile Next Mobile in Claude Code

• If Mobile Next Mobile MCP fails to start, check npx @mobilenext/mobile-mcp@latest (Node.js/npm), the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.
• Mobile Next Mobile MCP uses stdio here: Claude Code 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 Claude Code troubleshooting lives in the /clients/claude-code guide.

Frequently asked questions