mcp-devices 4.0.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

Edition	Best for	Install
claude-in-mobile	Want it all in one, zero setup	npm i -g claude-in-mobile
mcp-devices	Want a slim base + only the platforms you need	npm i -g mcp-devices (+ platform plugins, below)

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)

# 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" } } }

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

Check prerequisites any time: mcp-devices doctor.

Pick your platform

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

Platform	Install	Needs	Guide
Android	npm i -g @mcp-devices/plugin-android	adb	android »
iOS	npm i -g @mcp-devices/plugin-ios	xcrun (macOS/Xcode)	ios »
Web	npm i -g @mcp-devices/plugin-web	Chrome	web »
Desktop	npm i -g @mcp-devices/plugin-desktop	Java/JDK	desktop »
Aurora	npm i -g @mcp-devices/plugin-aurora	flutter-aurora	aurora »
All	npm i -g @mcp-devices/plugin-all	—	—

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.

• Your claude-in-mobile command keeps working either way — mcp-devices installs both the mcp-devices and claude-in-mobile binaries.
• 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
• Debug plugin — runtime debugging
• Built-in tools reference — every tool + action

Notes

• The modular base loads no platforms by default — you enable the ones you need (mcp-devices install <name>). The claude-in-mobile edition enables them all.
• The debug plugin isn't yet part of mcp-devices install — enable it with MCP_DEVICES_TOOL_PLUGINS=debug or ~/.mcp-devices/config.json.
• Prefer everything in one package? Use the all-in-one claude-in-mobile edition (npm i -g claude-in-mobile) — still maintained, install unchanged.