SimUtil MCP server
Commit Nov 10, 2026Lets an AI client launch, stream, control, record and automate Android emulators, iOS simulators and real devices from one place.
Also known as dungngminh/simutil
- Stars
- 1,221
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 10, 2026
- License
- MIT
What is SimUtil MCP?
SimUtil lets an AI client launch, stream, control, record and automate Android emulators, iOS simulators and real devices from one place.
Summary generated from the project's README
About SimUtil MCP server
Managing mobile testing environments by juggling Android Studio, Xcode, and various command line tools is what SimUtil simplifies for mobile developers. This tool centralizes the management of Android emulators, iOS simulators, and physical mobile devices through a single interface. It allows users to launch, stream, control, and record device screens without needing to open a full IDE.
Developers can interact with devices via a desktop application or a command line interface on macOS, Linux, and Windows. The MCP server integration enables AI agents in clients like Claude Code, Cursor, or VS Code to drive devices directly. While Android support is universal, iOS features require a macOS host with Xcode installed. The system supports advanced tasks like running YAML-based scenarios, connecting real Android phones over Wi-Fi via QR codes, and even slimming down iOS simulators to use significantly less memory.
What you can do with it
- 1Automate mobile UI testingAn AI agent can execute a sequence of taps and swipes across multiple devices using YAML steps.
- 2Stream and control devicesDevelopers can view and interact with multiple emulators or real phones in a side-by-side grid layout.
- 3Manage device lifecycle via CLIUsers can boot, shut down, or wipe data from specific emulators using terminal commands.
- 4Debug mobile applicationsA developer can monitor device logs with specific filtering to troubleshoot app issues.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabledungngminh/simutil is public and reachablegithub.com/dungngminh/simutil ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/dungngminh/simutil ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubMobile development means juggling Android Studio, Xcode, adb, simctl,
scrcpy and a pile of scripts just to get a device up and look at it.
SimUtil puts those chores in one place, without opening an IDE:
- SimUtil Desktop — stream and control many devices side by side (emulators, simulators, real Android phones and real iPhones / iPads), record them, run scenarios across them, and let AI agents drive them over MCP.
simutilCLI — list, launch and shut down devices, connect over Wi-Fi, read Logcat and run your own tools from scripts or the terminal.- Dart packages — the same device services (
adb,simctl,devicectl) as libraries for your own tooling.
Runs on macOS, Linux and Windows. iOS features need macOS (Xcode).
https://github.com/user-attachments/assets/b0463741-6d31-496d-99a8-264a5e69457a
Utilities
| Utility | Desktop | CLI | |
|---|---|---|---|
| Devices | Start / stop emulators and simulators, headless or with their window | ✓ | ✓ |
| Android launch options: cold boot, no audio | ✓ | ✓ | |
| Wipe data or delete an emulator / simulator | ✓ | ||
| Slim iOS simulators (about 1 GB of memory instead of 4 GB) | ✓ | ||
| Stream & control | Many devices side by side, grid or spotlight layout | ✓ | |
| Real Android phones over USB or Wi-Fi | ✓ | ||
| Touch, swipe, navigation buttons and keyboard typing on every stream | ✓ | ||
| Real iPhones / iPads connected by USB: device frame, screenshots, recording with sound (view only, macOS) | ✓ | ||
| Built-in scrcpy server, no separate install | ✓ | ||
| Connect | Wireless ADB by QR code, pairing code or IP | ✓ | ✓ |
| Capture | Screenshot one device or the whole grid | ✓ | |
| Record one device or the whole grid (native 60 fps on macOS) | ✓ | ||
| Apps | Install by dropping an .apk / .app / .ipa on a device |
✓ | |
| Convert an iPhone build so it runs on a simulator (Apple Silicon) | ✓ | ||
| Test & automate | Scenario studio: YAML steps (tap by label, swipe, type, assert) on many devices at once | ✓ | |
| MCP server for Claude Code, Codex, Cursor, Gemini CLI, VS Code | ✓ | ||
| JSON output and a full command schema for scripts and agents | ✓ | ||
| Debug | Logcat with filtering | ✓ | |
| Custom tools (scrcpy, Maestro, scripts) as YAML plugins | ✓ | ||
| Clean up | Clear Xcode DerivedData after a size preview (macOS) | ✓ | ✓ |
Install
SimUtil Desktop
Installers are on the releases page
(app-v* tags). The app updates itself in place from where you installed it.
macOS (Monterey or later; pulls in adb and ffmpeg):
brew update
brew tap dungngminh/simutil
brew install --cask simutil-desktop
Or download SimUtil-macos.dmg and drag SimUtil into Applications.
Windows: run SimUtil-windows-x64-setup.exe from the
latest desktop release.
The installer offers to install Android platform-tools and FFmpeg.
Linux (x86_64 AppImage; installs adb, ffmpeg and FUSE, re-run to update):
curl -fsSL https://raw.githubusercontent.com/dungngminh/simutil/main/app/packaging/linux/install.sh | bash
More, including the MCP tool list: app/README.md.
simutil CLI
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/dungngminh/simutil/main/install.sh | bash
# Homebrew
brew tap dungngminh/simutil && brew install simutil
# pub.dev
dart pub global activate simutil
Windows (PowerShell):
powershell -ExecutionPolicy Bypass -Command "iwr -useb https://raw.githubusercontent.com/dungngminh/simutil/main/install.ps1 | iex"
simutil upgrade updates it the same way you installed it. simutil checks for
a new release at most once a day; set SIMUTIL_NO_UPDATE_CHECK=1 to turn that off.
CLI usage
simutil list -v # devices on every platform, grouped
simutil list --json # for scripts and agents
simutil launch <device-id> # boot (alias: start)
simutil launch <id> -c --no-audio # cold boot, no audio (Android)
simutil launch <id> --headless # no emulator window / Simulator app
simutil shutdown <device-id> # alias: stop
simutil wipe <device-id> # erase data of a shut-down device (asks y/N)
simutil delete <device-id> -y # delete it; -y skips the prompt
simutil android device list -r # running adb devices only
simutil plugin run scrcpy mirror -d emulator-5554
simutil schema # every command as JSON, for agents
Run simutil with no arguments for an interactive device picker with ADB
tools, Logcat and plugins. simutil <command> --help lists each command's flags.
Plugins
Wire external tools (scrcpy, Maestro, your own scripts) to a device in
~/.simutil/settings.yaml, no code changes needed:
plugins:
- id: scrcpy
label: scrcpy
availability:
command: scrcpy
args: [--version]
commands:
- id: mirror
label: Screen Mirror
command: scrcpy
args: [-s, "{device.id}"]
platforms: [android]
requires_running: true
Full reference: docs/plugins.md.
Supported platforms
| Host OS | Android emulators & devices | iOS simulators & devices |
|---|---|---|
| macOS | Yes | Yes (requires Xcode) |
| Linux | Yes | No |
| Windows | Yes | No |
iOS support uses Apple's tools (xcrun simctl, xcrun devicectl), which only
exist on macOS. On Xcode 27+, a simulator opens in DeviceHub.app; earlier
versions use Simulator.app.
Packages
Monorepo (pub workspace); each package is versioned and published separately:
| Package | Contents |
|---|---|
app |
SimUtil Desktop: multi-device streaming, recording, scenarios, MCP server |
simutil |
The simutil CLI |
simutil_core |
Models, CommandExec, DeviceService |
simutil_adb |
Android: devices, wireless ADB, scrcpy session, Logcat |
simutil_apple |
Apple: simulators, physical devices, Xcode cache |
simutil_plugins |
YAML plugin catalog and runner |
simutil_shared |
Shared app layer: settings, app state, changelog |
simutil_h264 |
Native H.264 decoding into Flutter textures |
Contributing
git clone https://github.com/dungngminh/simutil.git
cd simutil
flutter pub get # whole workspace, desktop app included
dart run melos run check # analyze + Dart and Flutter tests
cd app && flutter run -d macos
Fork, branch, open a Pull Request. Architecture notes: docs/ai/architecture.md.
License
MIT — see LICENSE
SimUtil MCP questions
What devices can SimUtil control?
SimUtil manages Android emulators, iOS simulators, and real Android and iOS devices. It can launch, stream, control and record them.
Does SimUtil have an MCP server for AI agents?
Yes, SimUtil Desktop includes an MCP server that works with Claude Code, Codex, Cursor, Gemini CLI and VS Code.
Which operating systems does SimUtil run on?
SimUtil runs on macOS, Linux and Windows, but iOS features require macOS with Xcode installed.
Can SimUtil automate UI tests across multiple devices?
Yes, the scenario studio runs YAML steps like tap by label, swipe, type and assert on many devices at once.
Does SimUtil support wireless connections to Android devices?
Yes, it offers wireless ADB pairing by QR code, pairing code or IP address.