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 "Install 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 Related Servers Score Discussions

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 installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/xzaleksey/open-mobile-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server