# mobile-mcp

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 9946
- Author: mobile-next
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mobile-next/mobile-mcp
- Updated: 2026-10-18
- HTML: https://affpapa.org/en/nevibecode/mcp/mobile-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mobile-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@mobilenext/mobile-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mobile-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mobilenext/mobile-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp
```

## When to use it
- 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
- 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.

## Similar
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11912
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6505

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md