
mcp-devices
Mobile device automation CLI for Android, iOS, Aurora OS, and Desktop platforms
- version
- 4.4.1
- GitHub stars
- 385
Install
/plugin install mcp-devices@mcp-devicesRun it inside Claude Code after adding the marketplace with /plugin marketplace add AlexGladkov/claude-in-mobile.
Contents
Discovered from sourceSkills 1
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 platforms
mcp-devices-cli devices android # Android only
mcp-devices-cli devices ios # iOS simulators only
mcp-devices-cli devices --platform harmony # HarmonyOS devices only
mcp-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
MCP servers 1
Sponsors
Details
- Marketplace
- AlexGladkov/claude-in-mobile
- Source
- cli/plugin
- Category
- Community