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-devices

Run it inside Claude Code after adding the marketplace with /plugin marketplace add AlexGladkov/claude-in-mobile.

Contents

Discovered from source

Skills 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

FlagDescriptionPlatforms
--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:

ReferenceCommandsPlatforms
references/core.mdscreenshot, gestures, apps, logs, shell, Perfetto/xctrace traces, Android/iOS heap artifacts, and moreCross-platform
references/android-only.mdanalyze-screen, find-and-tap, screen on/offAndroid
references/desktop.mdget-window-info, focus-window, resize-window, launch/stop desktop apps, metrics, monitorsDesktop
references/platform-support.mdPer-platform support matrix and backend detailsAll

Tips

  • Use --compress on screenshots when sending to LLM — reduces token usage significantly
  • analyze-screen gives structured JSON of buttons/inputs/texts — useful for automated testing
  • find-and-tap uses 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 N for reliable element interaction by index
  • Use wait between actions in automation scripts to allow UI transitions

MCP servers 1

Sponsors

Details

Marketplace
AlexGladkov/claude-in-mobile
Source
cli/plugin
Category
Community