mcp-devices 4.2.0 (ex-claude-in-mobile)

👉 Want everything in one package? Keep using claude-in-mobile.

Nothing changes for you. Same install, all platforms bundled, still
maintained:

npm i -g claude-in-mobile

That's it — the all-in-one edition. Read on only if you'd rather install the
platforms separately (that's what mcp-devices is for).

Two editions — same tool

Both are maintained. claude-in-mobile was renamed to mcp-devices in 4.0 and
split into a modular edition; the all-in-one keeps its name and its unchanged
install. The rest of this README covers the modular mcp-devices edition.

Install in 3 steps (modular)

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.

Native shell CLI

The npm command mcp-devices is the Node.js MCP server. For direct shell
automation, install the native Rust CLI and use its unambiguous command name:

brew install AlexGladkov/tap/mcp-devices
mcp-devices-cli --help
mcp-devices-cli devices

The separate name prevents a global npm install from shadowing the native CLI
on PATH.

Pick your platform

Each platform is a separate package. Install the one(s) you need — full guide in
each doc:

After installing a package, enable it: mcp-devices install <name> (or all),
then restart.

What it can do

• Drive apps — screenshots, taps/swipes/typing, app launch, UI tree, shell,
  logs, permissions, files.
• Debug live apps — breakpoints, stepping, inspect variables, evaluate
  expressions (Android JDWP + iOS LLDB). See debug ».
• Test — visual regression, accessibility audit, performance, sensor/network
  simulation.

These come as ~20 built-in tool modules plus the on-demand debug plugin —
full tool catalog ».

Switching from all-in-one to modular?

Happy with the bundled claude-in-mobile? Do nothing — it stays maintained
and installs exactly as before. This section is only if you want to move to the
slim modular edition.

• The Node MCP commands claude-in-mobile and mcp-devices keep working;
  the native shell interface is available as mcp-devices-cli.
• The only difference is that platforms aren't bundled — install the one(s) you
  actually use:

npm i -g mcp-devices
npm i -g @mcp-devices/plugin-android   # (or plugin-all for everything)
mcp-devices install android

Tools, actions, and MCP client config are identical to the bundled edition.

Docs

• Modules & tools overview — how it's organized
• Platforms: android · ios · web · desktop · aurora · harmony
• Debug plugin — runtime debugging
• Built-in tools reference — every tool + action

Notes

• The modular base loads no platforms by default — enable them with
  mcp-devices install <name>. The claude-in-mobile edition enables all.
• Enable the separately installed debug plugin with
  mcp-devices plugin enable debug; MCP_DEVICES_TOOL_PLUGINS=debug remains
  available as a per-run override.
• Prefer everything in one package? Use the all-in-one claude-in-mobile
  edition (npm i -g claude-in-mobile) — still maintained, install unchanged.

{
  "name": "mcp-devices",
  "owner": {
    "name": "AlexGladkov",
    "url": "https://github.com/AlexGladkov"
  },
  "plugins": [
    {
      "name": "mcp-devices",
      "description": "Mobile device automation CLI for Android, iOS, Aurora OS, and Desktop platforms",
      "source": "./cli/plugin",
      "version": "4.4.1"
    }
  ]
}