Mobile Next Mobile MCP for Claude Desktop: Setup & Config

What you can do with Mobile Next Mobile in Claude Desktop

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

• Test native app flows across Android and iOS.
• Automate form entry and navigation on real or simulated devices.

Before you start: Mobile Next Mobile in Claude Desktop

• 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 Desktop configuration

1. Choose Claude Desktop configuration scope

   For Mobile Next Mobile MCP, open macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json. Merge under mcpServers via Settings → Developer → Edit Config when available.

2. Add Mobile Next Mobile MCP to Claude Desktop

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

3. Check Mobile Next Mobile MCP in Claude Desktop

   Mobile Next Mobile MCP: Fully quit and reopen Claude Desktop; check developer diagnostics.

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

Mobile Next Mobile tools available to Claude Desktop

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

mobile_list_available_devices

When Claude Desktop requests mobile_list_available_devices from Mobile Next Mobile, review the action before approving it.

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

mobile_login_to_cloud_provider

When Claude Desktop requests mobile_login_to_cloud_provider from Mobile Next Mobile, review the action before approving it.

Begin authentication with the remote device cloud provider.

mobile_list_remote_devices

When Claude Desktop requests mobile_list_remote_devices from Mobile Next Mobile, review the action before approving it.

Browse device models available in the cloud fleet.

mobile_allocate_remote_device

When Claude Desktop requests mobile_allocate_remote_device from Mobile Next Mobile, review the action before approving it.

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

mobile_release_remote_device

When Claude Desktop requests mobile_release_remote_device from Mobile Next Mobile, review the action before approving it.

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

mobile_list_apps

When Claude Desktop requests mobile_list_apps from Mobile Next Mobile, review the action before approving it.

Enumerate applications installed on a device.

mobile_launch_app

When Claude Desktop requests mobile_launch_app from Mobile Next Mobile, review the action before approving it.

Start an application on the selected device.

mobile_terminate_app

When Claude Desktop requests mobile_terminate_app from Mobile Next Mobile, review the action before approving it.

Stop a running mobile application.

mobile_install_app

When Claude Desktop requests mobile_install_app from Mobile Next Mobile, review the action before approving it.

Add an application to a device.

mobile_uninstall_app

When Claude Desktop requests mobile_uninstall_app from Mobile Next Mobile, review the action before approving it.

Remove an application from a device.

mobile_get_screen_size

When Claude Desktop requests mobile_get_screen_size from Mobile Next Mobile, review the action before approving it.

Read display dimensions in pixels.

mobile_click_on_screen_at_coordinates

When Claude Desktop requests mobile_click_on_screen_at_coordinates from Mobile Next Mobile, review the action before approving it.

Tap the display at an x/y location.

mobile_double_tap_on_screen

When Claude Desktop requests mobile_double_tap_on_screen from Mobile Next Mobile, review the action before approving it.

Perform a double tap at screen coordinates.

mobile_long_press_on_screen_at_coordinates

When Claude Desktop requests mobile_long_press_on_screen_at_coordinates from Mobile Next Mobile, review the action before approving it.

Hold a press at a chosen screen location.

mobile_list_elements_on_screen

When Claude Desktop requests mobile_list_elements_on_screen from Mobile Next Mobile, review the action before approving it.

mobile_press_button

When Claude Desktop requests mobile_press_button from Mobile Next Mobile, review the action before approving it.

mobile_open_url

When Claude Desktop requests mobile_open_url from Mobile Next Mobile, review the action before approving it.

mobile_swipe_on_screen

When Claude Desktop requests mobile_swipe_on_screen from Mobile Next Mobile, review the action before approving it.

mobile_type_keys

When Claude Desktop requests mobile_type_keys from Mobile Next Mobile, review the action before approving it.

mobile_save_screenshot

When Claude Desktop requests mobile_save_screenshot from Mobile Next Mobile, review the action before approving it.

mobile_take_screenshot

When Claude Desktop requests mobile_take_screenshot from Mobile Next Mobile, review the action before approving it.

mobile_set_orientation

When Claude Desktop requests mobile_set_orientation from Mobile Next Mobile, review the action before approving it.

mobile_get_orientation

When Claude Desktop requests mobile_get_orientation from Mobile Next Mobile, review the action before approving it.

mobile_start_screen_recording

When Claude Desktop requests mobile_start_screen_recording from Mobile Next Mobile, review the action before approving it.

mobile_stop_screen_recording

When Claude Desktop requests mobile_stop_screen_recording from Mobile Next Mobile, review the action before approving it.

mobile_list_crashes

When Claude Desktop requests mobile_list_crashes from Mobile Next Mobile, review the action before approving it.

mobile_get_crash

When Claude Desktop requests mobile_get_crash from Mobile Next Mobile, review the action before approving it.

Mobile Next Mobile: full stored tool descriptions

Troubleshooting Mobile Next Mobile in Claude Desktop

• Fully quit and reopen Claude Desktop for Mobile Next Mobile MCP. If npx @mobilenext/mobile-mcp@latest (Node.js/npm) is missing, check the desktop process's PATH, which may differ from your terminal.
• Mobile Next Mobile MCP uses stdio here: Claude Desktop 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 Desktop troubleshooting lives in the /clients/claude-desktop guide.

Frequently asked questions