How do I install the mobai mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Mobai MCP Server

MCP server for MobAI - AI-powered mobile device automation

Local serverstdio

What is the Mobai MCP Server?

MCP server for MobAI - AI-powered mobile device automation

What the server does

MCP (Model Context Protocol) server for MobAI — AI-powered mobile device automation. Lets AI assistants (Claude Code, Cursor, Windsurf, Cline, and other MCP-compatible tools) control Android and iOS devices, emulators, and simulators via a single DSL-first interface.

Credentials and setup notes

Node.js 18+ - MobAI desktop app running locally (HTTP API on 127.0.0.1:8686) - A connected Android or iOS device, emulator, or simulator

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
list_devices	List all connected Android and iOS devices
get_device	Get details about a specific device
start_bridge	Start the automation bridge on a device (required before interaction)
stop_bridge	Stop the automation bridge
claim_device	Claim exclusive use of a device for this session (usually optional: acting on an unclaimed device auto-claims it)
release_device	Release one or all device leases held by this session
get_screenshot	Fast, low-quality screenshot for LLM visual analysis (may be downscaled; response includes scale factor)
save_screenshot	Full-quality PNG to disk for reporting, debugging, or sharing
list_apps	List installed apps on the device
install_app	Install an .apk or .ipa from a local file path
uninstall_app	Uninstall an app by bundle ID / package name
debug_app	Launch an app in debug mode and write stdout/stderr to a log file
execute_dsl	Primary tool. Execute a batch of DSL steps: tap, type, swipe, observe, assertions, web automation, metrics, screen recording, and more.
test_get_active	Get the active test project directory and its .mob cases
test_list_projects	List all known test project directories with their .mob cases
test_run	Run a .mob test case on a device (project_dir + case_path + device_id, optional params for ${name} substitution)

How to install the Mobai MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Node.js 18+ - MobAI desktop app running locally (HTTP API on 127.0.0.1:8686) - A connected Android or iOS device, emulator, or simulator

Example prompts to try

“Use Mobai MCP to Cursor.”
“Use Mobai MCP to Screenshots.”
“Use Mobai MCP to Apps.”

Frequently asked questions

MCP server for MobAI - AI-powered mobile device automation Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.