Mobile Pilot

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

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

• Setup and Configuration
• Tools Reference
• Troubleshooting
• Documentation Index

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]"

3. Run checks before opening a PR:

ruff check .
python scripts/test_install.py

4. For dashboard/UI changes, include a screenshot or short recording in the PR.

License

Apache 2.0