Mobile Pilot MCP
Provides tools for controlling iOS simulators, including launching apps, taking screenshots, performing gestures (tap, swipe, type), recording, and interacting with UI elements via accessibility tree.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Mobile Pilot MCP List my booted simulators and connect to the first one."
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.
Mobile Pilot MCP

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.pyCodex CLI equivalent:
codex mcp add mobile-pilot -- /path/to/mobile-pilot-mcp/venv/bin/mobile-pilot-mcpIf 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-mcpcodex mcp add mobile-pilot -e WDA_HOST=192.168.1.30 -- /path/to/mobile-pilot-mcp/venv/bin/mobile-pilot-mcpTry 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-servercodex mcp add dart -- dart mcp-serverRecommended split:
mobile-pilot-mcp: simulator control, screenshots, gestures, app/system actionsdart 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
Fork and clone the repository.
Set up local environment and install dev deps:
python3 -m venv venv
source venv/bin/activate
pip install -e "[dev]"Run checks before opening a PR:
ruff check .
python scripts/test_install.pyFor dashboard/UI changes, include a screenshot or short recording in the PR.
License
Apache 2.0
Available Tools
36 toolsaccept_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
Scored across 36 tools
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.
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.
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.
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
Related MCP Connectors
Let your AI agent control real iPhones: screenshots, tap, swipe, type and open apps.
Cloud iPhone Simulators for AI agents: build the Xcode project, read the screen, tap by label, test.
Cloud iPhones and Macs with Xcode for AI agents: build, run and test iOS apps, use the screen.
Let AI agents control Android and iOS devices on Mobilerun Cloud: screen, input, apps, workflows.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive control of iOS simulators and real devices through AI assistants, supporting app management, UI automation, screenshots, media operations, and location simulation for iOS development and testing workflows.8MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to control iOS Simulators and automate browsers by combining xcrun simctl, fb-idb, and Puppeteer for screenshot capture, device management, gestures, navigation, and DOM interaction.17 npm2MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI to control iOS simulators through the MCP protocol. Supports device management, UI automation, and network interception including screenshot capture, text input, and HTTP request mocking.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control real iPhones and simulators on macOS, allowing for UI interaction, testing, and automation.51 npm98MIT