Which integrations are available for this server?

Automates Android devices: capture screenshots, UI hierarchy, OCR, perform taps, swipes, typing, read logs, manage app lifecycle, and more. Manages Expo dependencies by running npx expo install and provides bundler management for React Native/Expo projects. Automates iOS devices via Maestro: perception (screenshots, UI hierarchy), interaction (tap, swipe, type), logging, and app lifecycle management. Manages the Metro JavaScript bundler: start, stop, and restart Metro for React Native app development.

How do I use open-mobile-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@open-mobile-mcp take a screenshot of the current screen" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

open-mobile-mcp

by xzaleksey

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

Open Mobile MCP Server 📱

An open-source Model Context Protocol (MCP) server for mobile automation. Give any LLM eyes and hands on a real Android or iOS device — screenshot, tap, swipe, read logs, and verify your app without writing test code.

Works with Claude Code, Claude Desktop, Cursor, and any other MCP-compatible client.

Features

Perception: Screenshots, semantic UI hierarchy, OCR, element finder, layout health analysis.
Interaction: Tap, swipe, type, pinch, rotate, long-press, hardware key presses.
Logging: Per-app Android log filtering via PID (pass deviceId + packageId to eliminate system noise). Background log watching via wait_for_log.
Environment: Metro bundler management, app lifecycle, deep links, screen recording, locale switching.
Text Input: Unicode/Cyrillic/CJK/Emoji support via ADB Keyboard with automatic keyboard restore.

Related MCP server: airi-android

Prerequisites

Node.js (v18+)
ADB installed and in PATH (for Android).
Maestro (required for iOS; fallback for Android input).
- Mac/Linux: curl -Ls "https://get.maestro.mobile.dev" | bash
- Windows:
  powershell -Command "iwr -useb https://get.maestro.mobile.dev | iex"
(Optional) ADB Keyboard — only needed for non-ASCII input (Unicode, Cyrillic, Emoji).
- Download from GitHub and install: adb install ADBKeyboard.apk.

Configuration

macOS / Linux

{
  "mcpServers": {
    "open-mobile-mcp": {
      "command": "npx",
      "args": ["open-mobile-mcp"]
    }
  }
}

Windows

{
  "mcpServers": {
    "open-mobile-mcp": {
      "command": "npx",
      "args": ["open-mobile-mcp"],
      "env": {
        "MAESTRO_HOME": "C:\\Users\\YOUR_USER\\.maestro",
        "PATH": "C:\\Users\\YOUR_USER\\.maestro\\maestro\\bin;C:\\Windows\\system32;C:\\Windows;..."
      }
    }
  }
}

Note: On Windows, explicitly setting MAESTRO_HOME and PATH is often required for maestro to be found.

git clone https://github.com/xzaleksey/open-mobile-mcp.git
cd open-mobile-mcp
npm install && npm run build

Then use "command": "node", "args": ["/path/to/open-mobile-mcp/build/index.js"] in your MCP config.

Tools

Perception

Tool	Platform	Description
`device_list`	Android/iOS	List connected emulators and simulators
`get_viewport`	Android/iOS	Screenshot (~800px wide). Use `originalWidth`/`originalHeight` for tap coordinates — the image is scaled down, tapping at image pixels will miss.
`get_semantic_hierarchy`	Android/iOS	Pruned UI tree as JSON
`get_screen_text`	Android/iOS	OCR via Tesseract.js (default `eng`)
`configure_ocr`	Android/iOS	Set default OCR language (e.g. `eng+fra`)
`find_element`	Android/iOS	Find elements by `testId`, `text`, or `contentDescription`
`wait_for_element`	Android/iOS	Poll until element appears (default 20s)
`get_element_image`	Android/iOS	Cropped screenshot of a specific element
`capture_diff`	—	Compare two base64 screenshots, returns diff %
`analyze_layout_health`	Android/iOS	Detect deep nesting and layout performance issues

Interaction

Tool	Platform	Description
`tap_on_element`	Android/iOS	Recommended — find + tap by selector. Note: text matching is exact; emoji prefixes (e.g. `🇫🇷 French A2`) break text matching — check `get_semantic_hierarchy` for exact text first.
`device_tap`	Android/iOS	Raw coordinate tap. Must use original device pixels, not screenshot pixels.
`device_swipe`	Android/iOS	Swipe by coordinates
`device_type`	Android/iOS	Type text (handles Unicode)
`device_pinch`	Android	Two-finger pinch/zoom
`device_rotate_gesture`	Android	Two-finger rotation
`device_press_key`	Android/iOS	Hardware keys: `back`, `home`, `recents`, `enter`, `delete`, `volume_up`, `volume_down`, `power`, `tab`, `search`, `space`, `menu`, `dpad_*`. Also accepts raw Android keycodes.

Environment & Logs

Tool	Platform	Description
`manage_bundler`	Android/iOS	Start/stop/restart Metro. Pass `deviceId` + `packageId` for PID-based Android log filtering.
`manage_platform_logs`	Android/iOS	Manual control over `adb logcat` / `xcrun` capture. Pass `deviceId` + `packageId` for per-app filtering.
`get_bundler_logs`	Android/iOS	Recent Metro/Android/iOS logs. Returns `[status]` line — if buffer is empty, capture may not be running.
`stream_errors`	Android/iOS	Recent error/exception lines across all sources
`get_network_logs`	Android/iOS	Network logcat lines. For iOS, filters the internal log capture buffer (enable via `manage_platform_logs`).
`wait_for_log`	Android/iOS	Block until a log pattern matches. See subagent pattern below.
`manage_app_lifecycle`	Android/iOS	Launch, stop, install, or uninstall apps
`open_deep_link`	Android/iOS	Open a URL or deep link
`clear_app_data`	Android/iOS	Reset app to fresh-install state
`get_app_info`	Android	Version, permissions, install date
`start_recording` / `stop_recording`	Android/iOS	Screen recording to `.mp4` (Android uses `screenrecord`, iOS uses `simctl io`).
`run_maestro_flow`	Android/iOS	Run a Maestro YAML flow
`run_doctor`	—	Run `npx expo-doctor`
`install_deps`	—	Run `npx expo install <packages>`

wait_for_log — Background Subagent Pattern

wait_for_log blocks until a pattern appears in the log buffer. Calling it directly in the main agent freezes the conversation. Always delegate it to a background subagent in Claude Code:

// Step 1 — spawn the watcher BEFORE the action that will trigger the log
// (In Claude Code, use Agent tool with run_in_background: true)
// Subagent prompt: "Call wait_for_log with pattern 'route: /home', timeout 60000. Report the result."

// Step 2 — perform the action in the main agent
tap_on_element({ selector: "Home", strategy: "text" });

// Step 3 — main agent continues freely; gets notified when subagent finishes

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

mobilerun
io.github.droidrun
Control real Android and iOS devices with LLM agents — tap, swipe, type, automate flows.
Testing & QA Tools App Automation
38,854
anotherai
dev.anotherai
MCP server for building and testing AI agents with multi-model experimentation and insights.
Agent Orchestration Autonomous Agents Testing & QA Tools
2
llm-orchestration-agent-2
ai.getvda
MCP-Native LLM Orchestration Agent
Agent Orchestration AI & Machine Learning
1
Melaya
org.melaya
Melaya is a remote MCP server. It gives an assistant hands on your own Android phone and browser: it reads the screen through the accessibility tree, then taps, types and navigates inside the apps and sites you allow-list, with no per-app API. It also builds, schedules and runs agent pipelines across 6k+ connected tools. OAuth 2.1, nothing to install.
Agent Orchestration App Automation Browser Automation
1

Related MCP Servers

Mobile Next MCP
App Automation Agent Orchestration
EmpathySlainLovers
A
license
A
quality
D
maintenance
A Model Context Protocol server that enables scalable mobile automation for iOS and Android through a platform-agnostic interface, allowing LLMs to interact with mobile applications via accessibility snapshots or screenshot-based inputs.
Updated a year ago (2025-06-24 21:19 UTC)
19
23,436 npm
2
Apache 2.0
airi-android
OS Automation Shell Access Command Line
proj-airi
A
license
Not graded
quality
D
maintenance
A MCP server that enables LLMs to control Android devices via ADB, supporting input, UI hierarchy, device management, and shell commands.
Updated 8 months ago (2026-01-14 11:38 UTC)
14
MIT
agentic-android
OS Automation Autonomous Agents Testing & QA Tools
xDope7137
A
license
Not graded
quality
C
maintenance
MCP server that enables LLMs to control Android devices via ADB, providing tools for screen interaction and UI inspection.
Updated 2 months ago (2026-07-28 12:17 UTC)
1
MIT
Manos MCP
Testing & QA Tools Developer Tools
ryanperkins
A
license
A
quality
C
maintenance
A Model Context Protocol server for ad-hoc UI testing of Android and iOS apps, enabling LLM agents to interact with mobile app UIs and react to observations.
Updated 3 months ago (2026-06-18 20:57 UTC)
40
11 npm
3
MIT