Skip to content
Back to search

claude-in-mobile

SkillWorks with Claude CodeGitHub

MCP server for mobile and desktop automation — Android (via ADB), iOS Simulator (via simctl), and Desktop (Compose Multiplatform). Like Claude in Chrome but for mobile devices and desktop apps

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alexgladkov--claude-in-mobile/badge.svg)](/listings/alexgladkov--claude-in-mobile)

HTML

<a href="/listings/alexgladkov--claude-in-mobile"><img src="/api/listings/alexgladkov--claude-in-mobile/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires Node.js 20 or newer.

# 1. base server
npm i -g mcp-devices

# 2. add a platform (example: Android)
npm i -g @mcp-devices/plugin-android
mcp-devices install android

# 3. point your MCP client at it
#    { "mcpServers": { "mobile": { "command": "mcp-devices" } } }
# Grok Build:
#    grok plugin marketplace add AlexGladkov/claude-in-mobile
#    grok plugin install mcp-devices --trust

Restart your MCP client. Done — ask Claude *"take a screenshot of my Android device"* and it works.

Check prerequisites any time: `mcp-devices doctor`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "mcp-devices",
  3. "owner": {
  4. "name": "AlexGladkov",
  5. "url": "https://github.com/AlexGladkov"
  6. },
  7. "plugins": [
  8. {
  9. "name": "mcp-devices",
  10. "description": "Mobile device automation CLI for Android, iOS, Aurora OS, and Desktop platforms",
  11. "source": "./cli/plugin",
  12. "version": "4.4.1"
  13. }
  14. ]
  15. }
README.md · README · 131 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # mcp-devices 4.2.0 (ex-`claude-in-mobile`)
  2. > ## 👉 Want everything in one package? Keep using `claude-in-mobile`.
  3. >
  4. > **Nothing changes for you.** Same install, all platforms bundled, still
  5. > maintained:
  6. >
  7. > ```sh
  8. > npm i -g claude-in-mobile
  9. > ```
  10. >
  11. > That's it — the all-in-one edition. **Read on only if you'd rather install the
  12. > platforms separately** (that's what `mcp-devices` is for).
  13. ---
  14. ## Two editions — same tool
  15. | Edition | Best for | Install |
  16. |---------|----------|---------|
  17. | **`claude-in-mobile`** | Want it all in one, zero setup | `npm i -g claude-in-mobile` |
  18. | **`mcp-devices`** | Want a slim base + only the platforms you need | `npm i -g mcp-devices` (+ platform plugins, below) |
  19. Both are maintained. `claude-in-mobile` was renamed to `mcp-devices` in 4.0 and
  20. split into a modular edition; the all-in-one keeps its name and its unchanged
  21. install. The rest of this README covers the **modular `mcp-devices`** edition.
  22. ---
  23. ## Install in 3 steps (modular)
  24. Requires Node.js 20 or newer.
  25. ```sh
  26. # 1. base server
  27. npm i -g mcp-devices
  28. # 2. add a platform (example: Android)
  29. npm i -g @mcp-devices/plugin-android
  30. mcp-devices install android
  31. # 3. point your MCP client at it
  32. # { "mcpServers": { "mobile": { "command": "mcp-devices" } } }
  33. # Grok Build:
  34. # grok plugin marketplace add AlexGladkov/claude-in-mobile
  35. # grok plugin install mcp-devices --trust
  36. ```
  37. Restart your MCP client. Done — ask Claude *"take a screenshot of my Android
  38. device"* and it works.
  39. Check prerequisites any time: `mcp-devices doctor`.
  40. ## Native shell CLI
  41. The npm command `mcp-devices` is the Node.js MCP server. For direct shell
  42. automation, install the native Rust CLI and use its unambiguous command name:
  43. ```sh
  44. brew install AlexGladkov/tap/mcp-devices
  45. mcp-devices-cli --help
  46. mcp-devices-cli devices
  47. ```
  48. The separate name prevents a global npm install from shadowing the native CLI
  49. on `PATH`.
  50. ## Pick your platform
  51. Each platform is a separate package. Install the one(s) you need — full guide in
  52. each doc:
  53. | Platform | Install | Needs | Guide |
  54. |----------|---------|-------|-------|
  55. | Android | `npm i -g @mcp-devices/plugin-android` | `adb` | [android »](./docs/modules/plugin-android.md) |
  56. | iOS | `npm i -g @mcp-devices/plugin-ios` | `xcrun` (macOS/Xcode) | [ios »](./docs/modules/plugin-ios.md) |
  57. | Web | `npm i -g @mcp-devices/plugin-web` | Chrome | [web »](./docs/modules/plugin-web.md) |
  58. | Desktop | `npm i -g @mcp-devices/plugin-desktop` | Java/JDK | [desktop »](./docs/modules/plugin-desktop.md) |
  59. | Aurora | `npm i -g @mcp-devices/plugin-aurora` | `flutter-aurora` | [aurora »](./docs/modules/plugin-aurora.md) |
  60. | HarmonyOS Next | `npm i -g @mcp-devices/plugin-harmony` | `hdc` (DevEco Studio) | [harmony »](./docs/modules/plugin-harmony.md) |
  61. | All | `npm i -g @mcp-devices/plugin-all` | — | — |
  62. After installing a package, enable it: `mcp-devices install <name>` (or `all`),
  63. then restart.
  64. ## What it can do
  65. - **Drive apps** — screenshots, taps/swipes/typing, app launch, UI tree, shell,
  66. logs, permissions, files.
  67. - **Debug live apps** — breakpoints, stepping, inspect variables, evaluate
  68. expressions (Android JDWP + iOS LLDB). See [debug »](./docs/modules/plugin-debug.md).
  69. - **Test** — visual regression, accessibility audit, performance, sensor/network
  70. simulation.
  71. These come as ~20 built-in tool modules plus the on-demand debug plugin —
  72. [full tool catalog »](./docs/modules/built-in-tools.md).
  73. ## Switching from all-in-one to modular?
  74. Happy with the bundled `claude-in-mobile`? **Do nothing** — it stays maintained
  75. and installs exactly as before. This section is only if you *want* to move to the
  76. slim modular edition.
  77. - The Node MCP commands `claude-in-mobile` and `mcp-devices` keep working;
  78. the native shell interface is available as `mcp-devices-cli`.
  79. - The only difference is that platforms aren't bundled — install the one(s) you
  80. actually use:
  81. ```sh
  82. npm i -g mcp-devices
  83. npm i -g @mcp-devices/plugin-android # (or plugin-all for everything)
  84. mcp-devices install android
  85. ```
  86. Tools, actions, and MCP client config are identical to the bundled edition.
  87. ## Docs
  88. - [Modules & tools overview](./docs/modules/README.md) — how it's organized
  89. - Platforms: [android](./docs/modules/plugin-android.md) · [ios](./docs/modules/plugin-ios.md) · [web](./docs/modules/plugin-web.md) · [desktop](./docs/modules/plugin-desktop.md) · [aurora](./docs/modules/plugin-aurora.md) · [harmony](./docs/modules/plugin-harmony.md)
  90. - [Debug plugin](./docs/modules/plugin-debug.md) — runtime debugging
  91. - [Built-in tools reference](./docs/modules/built-in-tools.md) — every tool + action
  92. ## Notes
  93. - The modular base loads no platforms by default — enable them with
  94. `mcp-devices install <name>`. The `claude-in-mobile` edition enables all.
  95. - Enable the separately installed debug plugin with
  96. `mcp-devices plugin enable debug`; `MCP_DEVICES_TOOL_PLUGINS=debug` remains
  97. available as a per-run override.
  98. - Prefer everything in one package? Use the all-in-one **`claude-in-mobile`**
  99. edition (`npm i -g claude-in-mobile`) — still maintained, install unchanged.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.