MCP server CX Codex

mobile-mcp — Claude Code MCP server: what it does, how to install

Q: How to install mobile-mcp in Claude Code?

Run `claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp` in your terminal. This registers the server and exposes its tools to the agent.

Q: What local dependencies are required for mobile-mcp?

Testing on iOS requires Xcode with `xcrun simctl`. Android devices and emulators require the Android SDK and `adb` with USB debugging enabled.

Connects iOS and Android devices to your AI agent. Useful for automating app testing, reading UI elements, and running user flows without native framework scripts.

Install into Claude Code · Platform CLI All methods and platforms ↓

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp

Open on GitHub

What mobile-mcp does

This server translates agent commands into mobile actions across iOS and Android targets. It inspects interfaces via the native accessibility tree, keeping token costs down because vision models are not queried on every step. When an interface requires visual verification, the server falls back to coordinate taps from screenshots.

The toolset covers installing .apk or .ipa packages, launching applications, simulating gestures, changing device orientation, and spoofing GPS coordinates. It works with local simulators, physical USB-connected phones, and cloud instances.

Local execution depends on native tooling. For iOS simulators, you need Xcode with xcrun simctl. Android targets require the Android SDK and adb. Without these tools, local automation will not start.

What it helps with

automate native app test flows across iOS and Android
install and launch .apk or .ipa builds directly from the agent
extract UI elements and coordinates via native accessibility trees
simulate device orientation shifts and GPS location overrides

Example prompts for the agent

Check available mobile devices and launch our app on the active Android emulator.
Inspect the current screen elements and tap the login button.
Install the latest build from the .apk file and capture a screenshot.

How to install mobile-mcp

Platform CLI

claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp

Platform CLI

codex mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp

Config file

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

Config file

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

Platform CLI

gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about mobile-mcp

How to install mobile-mcp in Claude Code?

Run claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp in your terminal. This registers the server and exposes its tools to the agent.

What does mobile-mcp do?

It provides a cross-platform interface for controlling mobile devices. Agents can inspect UI trees, tap buttons, manage apps, and capture screenshots.

What local dependencies are required for mobile-mcp?

Testing on iOS requires Xcode with xcrun simctl. Android devices and emulators require the Android SDK and adb with USB debugging enabled.

Similar MCP servers

Everything for Mobile →