Skip to main content
Glama
Mobile Pilot MCP

Mobile Pilot MCP

by bidouilles

Mobile Pilot MCP

Dashboard Screenshot

Build Status

Your AI co-pilot for mobile simulators.

Other tools let you tap. We give you a cockpit.

Mobile Pilot MCP gives AI assistants a control plane for simulator automation, visual validation, and repeatable mobile workflows.

Why Mobile Pilot MCP

  • Cockpit dashboard with real-time tool calls, device controls, and visual feedback

  • Fast automation loops for taps, swipes, typing, screenshots, recording, and app actions

  • Flutter-first workflow when paired with Dart MCP server

  • Cross-platform direction: iOS today, Android coming soon

Related MCP server: MCP Connect

Quick Start (4 Commands)

python3 -m venv venv && source venv/bin/activate && pip install -e .
./scripts/start_wda.sh <UDID>
claude mcp add mobile-pilot -- /path/to/mobile-pilot-mcp/venv/bin/mobile-pilot-mcp
python scripts/test_install.py

Codex CLI equivalent:

codex mcp add mobile-pilot -- /path/to/mobile-pilot-mcp/venv/bin/mobile-pilot-mcp

If WDA is not on localhost:

claude mcp add mobile-pilot -e WDA_HOST=192.168.1.30 -- /path/to/mobile-pilot-mcp/venv/bin/mobile-pilot-mcp
codex mcp add mobile-pilot -e WDA_HOST=192.168.1.30 -- /path/to/mobile-pilot-mcp/venv/bin/mobile-pilot-mcp

Try This First

Once connected in your MCP client, try prompts like:

  • List my booted simulators and connect to the first one.

  • Take a screenshot, then show me the UI tree and tap the Settings button.

  • Launch Safari, open https://flutter.dev, and capture another screenshot.

  • Start a recording, perform a swipe up, stop recording, and give me the output path.

Flutter + Dart MCP

Use both servers together for a stronger Flutter dev loop.

claude mcp add --transport stdio dart -- dart mcp-server
codex mcp add dart -- dart mcp-server

Recommended split:

  • mobile-pilot-mcp: simulator control, screenshots, gestures, app/system actions

  • dart mcp-server: runtime errors, widget/runtime introspection, hot reload, tests, pub.dev/package workflows

Reference: Supercharge Your Dart & Flutter Development Experience with the Dart and Flutter MCP Server

Comparison

Capability

Mobile Pilot MCP

Typical simulator-only MCP

Dashboard cockpit

Yes

Usually no

Real-time tool-call timeline

Yes

Usually no

Visual interaction loop (live screenshot + actions)

Yes

Partial

Flutter pairing story (Dart MCP)

First-class

Rare

Cross-platform roadmap

iOS now, Android planned

Often iOS-only

Dashboard

Available at http://localhost:8200 when the server starts.

Documentation

Contributing

  1. Fork and clone the repository.

  2. Set up local environment and install dev deps:

python3 -m venv venv
source venv/bin/activate
pip install -e "[dev]"
  1. Run checks before opening a PR:

ruff check .
python scripts/test_install.py
  1. For dashboard/UI changes, include a screenshot or short recording in the PR.

License

Apache 2.0

Available Tools

36 tools
accept_alertC

Accept the current alert dialog.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

boot_simulatorC

Boot an iOS simulator.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

clear_status_barA

Clear all status bar overrides and return to normal.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

discover_dtd_urisA

Discover running Dart Tooling Daemon (DTD) URIs for Flutter debugging.

These URIs can be used with the Dart MCP server's connect_dart_tooling_daemon tool for hot reload, widget inspection, and other Flutter debugging features.

Inputs: timeout. Returns: Generic wrapper for non-object return types.

dismiss_alertB

Dismiss the current alert dialog.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

dismiss_keyboardA

Dismiss the on-screen keyboard if visible.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

double_tapC

Double tap at coordinates.

Inputs: x (required), y (required), device_id (required). Returns: Generic wrapper for non-object return types.

get_alert_textA

Get the text of the current alert dialog.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

get_appearanceB

Get current device appearance (dark/light mode).

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

get_clipboardC

Get clipboard/pasteboard content.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

get_deviceC

Get information about a specific simulator.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

get_screenshotC

Capture a screenshot from the simulator with resizing and format options.

Inputs: device_id (required), scale, format, quality. Returns: Generic wrapper for non-object return types.

get_ui_treeB

Get the UI accessibility tree showing all visible elements with indices for tapping.

Inputs: device_id (required), format, verbose, only_visible. Returns: Generic wrapper for non-object return types.

get_window_sizeC

Get the simulator window/screen size.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

go_homeC

Navigate to home screen.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

launch_appB

Launch an application by bundle ID.

Inputs: bundle_id (required), device_id (required). Returns: Generic wrapper for non-object return types.

list_appsB

List installed applications on the simulator.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

list_devicesB

List all iOS simulators (booted and available).

Inputs: only_booted. Returns: Generic wrapper for non-object return types.

long_pressC

Long press at coordinates.

Inputs: x (required), y (required), device_id (required), duration. Returns: Generic wrapper for non-object return types.

open_urlA

Open a URL in the simulator (opens in Safari or associated app).

Inputs: url (required), device_id (required). Returns: Generic wrapper for non-object return types.

pinchC

Perform a pinch gesture (zoom in/out) at coordinates.

Inputs: x (required), y (required), scale (required), device_id (required), +1 more. Returns: Generic wrapper for non-object return types.

press_buttonC

Press a hardware button (home, volumeUp, volumeDown).

Inputs: button (required), device_id (required). Returns: Generic wrapper for non-object return types.

reset_sessionA

Reset the WDA session (useful if session expires or has errors).

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

set_appearanceB

Set device appearance (dark mode or light mode).

Inputs: device_id (required), appearance (required). Returns: Generic wrapper for non-object return types.

set_clipboardB

Set clipboard/pasteboard content.

Inputs: content (required), device_id (required). Returns: Generic wrapper for non-object return types.

set_locationB

Set the simulator's GPS location.

Inputs: latitude (required), device_id (required), longitude (required). Returns: Generic wrapper for non-object return types.

set_status_barB

Override status bar appearance for consistent screenshots.

Inputs: device_id (required), time, wifi_bars, wifi_mode, +6 more. Returns: Generic wrapper for non-object return types.

shutdown_simulatorC

Shutdown an iOS simulator.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

simulate_biometricsA

Simulate Touch ID or Face ID authentication (success or failure).

Inputs: device_id (required), match. Returns: Generic wrapper for non-object return types.

start_bridgeB

Check WebDriverAgent connection (WDA must be running separately via xcodebuild).

Inputs: device_id (required), host, port. Returns: Generic wrapper for non-object return types.

start_recordingA

Start screen recording. Use stop_recording to save the video (.mov file).

Inputs: device_id (required), codec. Returns: Generic wrapper for non-object return types.

stop_recordingA

Stop screen recording and save the video file.

Inputs: device_id (required). Returns: Generic wrapper for non-object return types.

swipeC

Perform a swipe gesture.

Inputs: device_id (required), to_x, to_y, from_x, +3 more. Returns: Generic wrapper for non-object return types.

tapB

Tap an element by index (from UI tree), predicate, or coordinates.

Inputs: device_id (required), x, y, index, +1 more. Returns: Generic wrapper for non-object return types.

terminate_appC

Terminate an application.

Inputs: bundle_id (required), device_id (required). Returns: Generic wrapper for non-object return types.

type_textB

Type text (tap input field first to focus, or provide predicate).

Inputs: text (required), device_id (required), predicate. Returns: Generic wrapper for non-object return types.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 36 tools

    Disambiguation4/5

    Most tools target distinct actions or resources, such as alerts, gestures, app control, and device settings. A few pairs could cause mild hesitation, like go_home vs press_button(home), or start_bridge vs reset_session, but descriptions generally clarify the boundaries.

    Naming Consistency4/5

    The toolset is consistently snake_case and mostly follows a verb_noun or verb_object pattern. Minor deviations appear in gesture-only names like tap, swipe, pinch, and long_press, but the convention remains readable and predictable.

    Tool Count2/5

    With 36 tools, the server is well above the 25-tool threshold for a heavy set. While the mobile automation domain is broad, many operations could be grouped or exposed more narrowly, making the surface feel over-scoped.

    Completeness4/5

    The surface covers a wide iOS simulator lifecycle: device management, gestures, app control, alerts, settings, clipboard, recording, and Flutter debugging. Some notable gaps remain, such as install/uninstall app operations and orientation controls, but core workflows are well supported.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers