Skill v1.0.0
currentLLM-judged scan90/100version: "1.0.0" name: mcp-devices description: "This skill should be used when the user asks to interact with device screens (screenshot, annotate, tap, swipe, type text), manage apps (install, launch, stop, uninstall), transfer files (push, pull), query device info (logs, system info, clipboard, screen size), capture performance traces or heap artifacts, run shell commands, manage desktop windows, or automate Android, iOS, HarmonyOS, Aurora OS, or Desktop apps."
mcp-devices native CLI
Fast CLI for mobile device automation across Android (via ADB), iOS (via simctl), HarmonyOS (via HDC), Aurora OS (via audb), and Desktop (via companion JSON-RPC app).
Binary: mcp-devices-cli (ensure it's in PATH or use its full path).
Common Flags
| Flag | Description | Platforms | |
|---|---|---|---|
--device <serial> | Android/HarmonyOS/Aurora device serial (default: first connected) | Android, HarmonyOS, Aurora | |
--simulator <name> | iOS Simulator name (default: booted) | iOS | |
--companion-path <path> | Path to Desktop companion app (or set MOBILE_TOOLS_COMPANION env) | Desktop |
Quick Reference
devices
List connected devices across platforms.
mcp-devices-cli devices # All platformsmcp-devices-cli devices android # Android onlymcp-devices-cli devices ios # iOS simulators onlymcp-devices-cli devices --platform harmony # HarmonyOS devices onlymcp-devices-cli devices aurora # Aurora devices only
Command Categories
Full command documentation split by scope:
| Reference | Commands | Platforms | |
|---|---|---|---|
| `references/core.md` | screenshot, gestures, apps, logs, shell, Perfetto/xctrace traces, Android/iOS heap artifacts, and more | Cross-platform | |
| `references/android-only.md` | analyze-screen, find-and-tap, screen on/off | Android | |
| `references/desktop.md` | get-window-info, focus-window, resize-window, launch/stop desktop apps, metrics, monitors | Desktop | |
| `references/platform-support.md` | Per-platform support matrix and backend details | All |
Tips
- Use
--compresson screenshots when sending to LLM — reduces token usage significantly analyze-screengives structured JSON of buttons/inputs/texts — useful for automated testingfind-and-tapuses fuzzy matching with confidence scoring — good for flaky element names- Aurora commands use
audb(Aurora Debug Bridge) — similar to ADB - Desktop commands communicate via JSON-RPC with a companion app over stdin/stdout
- Combine
ui-dump+tap --index Nfor reliable element interaction by index - Use
waitbetween actions in automation scripts to allow UI transitions