MCP Directory

How to add Mobile MCP to Claude Desktop

Platform-agnostic mobile automation for iOS & Android — simulators, emulators, and real devices. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 5.2k★ · stdio · no auth

Claude Desktop config for Mobile MCP

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

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Mobile MCP config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Mobile MCP's tools appear under the 🔌 tools menu.

Before you start

  • Xcode command line tools (for iOS)
  • Android Platform Tools / Android SDK (for Android)
  • Node.js v22+
  • An MCP-supported model or agent (e.g. Claude, OpenAI Agent SDK, Copilot Studio)
  • A connected iOS/Android real device, or a running iOS Simulator / Android Emulator

What Mobile MCP can do in Claude Desktop

mobile_list_available_devices

List all available devices (simulators, emulators, and real devices).

mobile_get_screen_size

Get the screen size of the mobile device in pixels.

mobile_get_orientation

Get the current screen orientation of the device.

mobile_set_orientation

Change the screen orientation (portrait/landscape).

mobile_list_apps

List all installed apps on the device.

mobile_launch_app

Launch an app using its package name.

mobile_terminate_app

Stop and terminate a running app.

mobile_install_app

Install an app from file (.apk, .ipa, .app, .zip).

Security

The standard stdio configuration requires no authentication. When running in SSE server mode (--listen), set the MOBILEMCP_AUTH environment variable to require a Bearer token (Authorization: Bearer <token>) on all requests. The server collects anonymous usage telemetry via PostHog; set MOBILEMCP_DISABLE_TELEMETRY=1 to disable it. The server can install/uninstall apps and fully control connected devices, simulators, and emulators, so only run it against devices you trust.

Mobile MCP + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Mobile MCP config there under the "mcpServers" key and restart the client.

Is Mobile MCP safe to use with Claude Desktop?

The standard stdio configuration requires no authentication. When running in SSE server mode (--listen), set the MOBILEMCP_AUTH environment variable to require a Bearer token (Authorization: Bearer <token>) on all requests. The server collects anonymous usage telemetry via PostHog; set MOBILEMCP_DISABLE_TELEMETRY=1 to disable it. The server can install/uninstall apps and fully control connected devices, simulators, and emulators, so only run it against devices you trust.

Which platforms and device types are supported?

iOS real devices and Simulators, and Android real devices and Emulators. iOS uses native accessibility and WebDriverAgent; Android uses ADB and UI Automator.

Does it require a computer vision model?

No. It uses native accessibility trees for most interactions and only falls back to screenshot-based coordinate analysis when accessibility data or view-hierarchy coordinates are unavailable.

How do I run it as an HTTP/SSE server instead of stdio?

By default it runs over stdio. Start an SSE server with `npx @mobilenext/mobile-mcp@latest --listen 3000` (or `--listen 0.0.0.0:3000`), then point your MCP client at http://<host>:3000/mcp. Set MOBILEMCP_AUTH to require a Bearer token.

View repo Full Mobile MCP page