Quick Start

For Claude Desktop / Cursor / Windsurf

Add to your MCP config:

{
  "mcpServers": {
    "openmob": {
      "command": "npx",
      "args": ["-y", "openmob-mcp"]
    }
  }
}

For VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "openmob": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "openmob-mcp"]
    }
  }
}

Prerequisites

1. OpenMob Hub must be running (download from releases)
2. Android device connected via USB, or emulator running

38 Tools + 3 Resources

MCP Resources

| URI | Description | |-----|-------------| | openmob://guide | Step-by-step usage guide | | openmob://tools | Full tool reference with descriptions | | openmob://status | Live Hub and device connection status |

Device Info (14 tools)

| Tool | What it does | |------|-------------| | list_devices | See all connected devices | | get_screenshot | Capture the device screen | | get_ui_tree | Read all UI elements with indices | | find_element | Smart search by text, class, resource ID | | get_screen_size | Get screen dimensions | | get_orientation | Check portrait/landscape | | list_apps | List installed apps | | get_current_activity | See current app/screen | | get_device_logs | Read logcat for debugging | | get_notifications | Read notification bar | | save_screenshot | Save screenshot to file | | wait_for_element | Wait for UI element to appear | | pair_wireless | Pair Android 11+ wirelessly (one-time) | | connect_wireless | Connect to device over WiFi |

Touch & Input (7 tools)

| Tool | What it does | |------|-------------| | tap | Tap by element index or coordinates | | double_tap | Double-tap gesture | | long_press | Long press with duration | | type_text | Type into focused field (+ optional submit) | | swipe | Scroll by direction or coordinates | | press_button | Press Home/Back/Volume/Power | | go_home | Go to home screen |

App Management (8 tools)

| Tool | What it does | |------|-------------| | launch_app | Open app by package name | | terminate_app | Kill running app | | install_app | Install APK from file | | uninstall_app | Remove app | | open_url | Open URL or deep link | | list_apps | List installed apps | | clear_app_data | Reset app to fresh state | | grant_permissions | Auto-grant all permissions |

Device Settings (3 tools)

| Tool | What it does | |------|-------------| | set_rotation | Rotate screen | | toggle_wifi | WiFi on/off | | toggle_airplane_mode | Airplane mode on/off |

Screen Recording (4 tools)

| Tool | What it does | |------|-------------| | start_recording | Record device screen | | stop_recording | Stop and save recording | | get_recording | Get recording details | | list_recordings | List all recordings |

Testing (1 tool)

| Tool | What it does | |------|-------------| | run_test | Run multi-step test scenario with automatic recording evidence |

How It Works

AI Agent (Claude / Cursor / Codex)
    |
    v
openmob-mcp (this package, stdio)
    |
    v
OpenMob Hub (localhost:8686)
    |
    v
ADB / xcrun simctl
    |
    v
Your Device

The MCP server is a thin proxy — all device operations go through the OpenMob Hub HTTP API. The Hub handles ADB commands, device state, and cross-platform support.

All tools also available with mobile_ prefix

For compatibility with mobile-mcp convention, every tool is also registered with a mobile_ prefix: mobile_tap, mobile_swipe, mobile_screenshot, etc.

Free & Open Source

OpenMob is a free, self-hosted alternative to MobAI. No quotas, no limits, no cloud dependency.

• GitHub
• Download Hub
• MIT License