How do I install Android?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Android need an API key?

The publisher lists these environment variables: ADB_PATH, ANDROID_HOME, ANDROID_SERIAL, ANDROID_TOOLS, ANDROID_DISABLE, ANDROID_MCP_ALLOW_SHELL, ANDROID_MCP_ALLOW_WRITE.

What transport does Android use?

Android runs locally over stdio.

When was Android last checked?

Last checked 2026-10-27. Android MCP server — 75 tools for ADB-based device management, UI automation, logcat, emulator control. Read-only by default.

Servidor MCP Android

Potencialize seu agente

Adicionar este servidor

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Rodar no PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @us-all/[email protected]

Credentials from the publisher

ADB_PATH — Path to adb binary. Default: 'adb' on PATH.
ANDROID_HOME — Android SDK root. Used to resolve adb if ADB_PATH not set.
ANDROID_SERIAL — Default device serial when multiple devices are connected.
ANDROID_TOOLS — Comma-separated category allowlist. Default: all categories enabled.
ANDROID_DISABLE — Comma-separated category disablelist.
ANDROID_MCP_ALLOW_SHELL — Set to 'true' to enable arbitrary shell command execution. Default disabled.
ANDROID_MCP_ALLOW_WRITE — Set to 'true' to enable write/destructive tools. Default read-only.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1ADB_PATH=<value> ANDROID_HOME=<value> ANDROID_SERIAL=<value> ANDROID_TOOLS=<value> ANDROID_DISABLE=<value> ANDROID_MCP_ALLOW_SHELL=<value> ANDROID_MCP_ALLOW_WRITE=<value> claude mcp add us-all-android-mcp-server -- npx -y @us-all/android-mcp@1.14.4

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "us-all-android-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@us-all/[email protected]"8      ],9      "env": {10        "ADB_PATH": "<value>",11        "ANDROID_HOME": "<value>",12        "ANDROID_SERIAL": "<value>",13        "ANDROID_TOOLS": "<value>",14        "ANDROID_DISABLE": "<value>",15        "ANDROID_MCP_ALLOW_SHELL": "<value>",16        "ANDROID_MCP_ALLOW_WRITE": "<value>"17      }18    }19  }20}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Rodar no PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Abrir

Server facts

Local

Transport: stdio
License

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Android MCP Server

The Android diagnostic & forensic MCP — when an app crashes, leaks memory, drains battery, or behaves unexpectedly, this is what you point at the device.

76 tools across logcat / dumpsys / package internals / system properties / processes. 5 MCP Prompts (crash-investigation, memory-leak-detection, permission-audit, app-startup-profile, ui-element-locator) and a device-health aggregation. Pure ADB, no Appium / uiautomator2 dependency. 2-tier security (write + shell gates).

What it does that others don't

Diagnostic depth — logcat search/crash extraction, dumpsys (mem/gfx/cpu), getprop, processes, package internals, app intents, port forwards. Cross-platform competitors hide this surface.
MCP Prompts (5) — crash-investigation, memory-leak-detection, ui-element-locator, app-startup-profile, permission-audit. Workflow templates the model invokes directly.
Aggregation tools — device-health (battery + memory + cpu + network in one call), analyze-app (package info + memory + activities).
2-tier security — ANDROID_MCP_ALLOW_WRITE (gates installs/taps/pushes) and ANDROID_MCP_ALLOW_SHELL (gates arbitrary adb shell) are separate flags. Distinct trust levels.
Pure ADB — no Appium, no uiautomator2, no Python bridge. Just the official Android Debug Bridge wrapped over child_process.
Token-efficient by design — 56 schema-trim sweep, ANDROID_TOOLS/ANDROID_DISABLE 9 categories, search-tools meta.
Apps SDK card — device-health renders as a snapshot card on ChatGPT clients (battery, RAM, Wi-Fi + 4-section grid) via _meta["openai/outputTemplate"]. Claude clients receive the same JSON content.
stdio + Streamable HTTP — defaults to stdio. Set MCP_TRANSPORT=http for ChatGPT Apps SDK or remote clients (Bearer auth via MCP_HTTP_TOKEN).

Try this — 5 prompts

Connect the server to Claude Desktop or Claude Code, then paste any of these:

Crash investigation — "My app com.us-all.api keeps crashing on this Pixel 6 emulator. Pull the last crash log, the offending stack frames, and any recent permission changes."
Memory leak detection — "Trace memory growth for com.us-all.api over the last 5 minutes. Show heap deltas, GC pressure, and the largest allocators."
Battery drain attribution — "What's draining battery on this device? Top 5 consumers, duration of each, and current battery health."
Permission audit — "Audit installed 3rd-party apps for dangerous permissions (location/camera/contacts/microphone). Flag any app that hasn't been used in the last 30 days but holds these."
App startup profile — "Profile the cold-start of com.us-all.api — measure activity launch time, identify the slowest fragment init, and suggest where to add tracing."

When to use this vs mobile-next/mobile-mcp

mobile-next/mobile-mcp (4.7K★) is the cross-platform action-oriented MCP. Different problem space:

	mobile-mcp	`@us-all/android-mcp` (this)
Platform	iOS + Android (cross-platform)	Android only (specialist)
Posture	Action-oriented ("drive the app via NL")	Diagnostic ("tell me why it broke")
UI surface	Accessibility-tree-first, action loops	UI hierarchy + screenshots + diagnostic dumps
Diagnostic depth	minimal	logcat / dumpsys / getprop / processes / crashes
Aggregations	—	`device-health`, `analyze-app`
MCP Prompts	—	5 (diagnostic-themed)
Security gates	basic	2-tier (write + shell separate)
Distribution	broad (12+ IDE buttons)	npm + Docker

Use both — they're complementary. mobile-mcp drives the device through your QA flows; this MCP tells you why it broke when something does. Especially:

mobile-mcp finds the bug via UI exploration → this MCP captures the crash log + heap dump.
mobile-mcp can't tell you why startup is slow → this MCP gives you dumpsys gfxinfo + activity launch timing.
mobile-mcp can't reproduce a permission denial → this MCP shows the exact dumpsys package permission state and recent grants.

Install

Claude Desktop

{
  "mcpServers": {
    "android": {
      "command": "npx",
      "args": ["-y", "@us-all/android-mcp"],
      "env": {
        "ANDROID_MCP_ALLOW_WRITE": "true"
      }
    }
  }
}

Claude Code

claude mcp add android -s user \
  -e ANDROID_MCP_ALLOW_WRITE=true \
  -e ANDROID_MCP_ALLOW_SHELL=true \
  -- npx -y @us-all/android-mcp

Docker

docker run --rm \
  --device /dev/bus/usb \
  -e ANDROID_MCP_ALLOW_WRITE=true \
  ghcr.io/us-all/android-mcp-server:latest

Build from source

git clone https://github.com/us-all/android-mcp-server.git
cd android-mcp-server && pnpm install && pnpm build
node dist/index.js

Prerequisites

ADB installed and on PATH (or set ADB_PATH)
Android device or emulator with USB debugging enabled
For multi-device setups: ANDROID_SERIAL=<serial> to target a specific one

Configuration

Variable	Required	Default	Description
`ANDROID_HOME`	❌	auto-detect	Android SDK path
`ADB_PATH`	❌	`adb` (PATH)	Path to ADB binary
`ANDROID_SERIAL`	❌	auto (single device)	Target device serial
`ANDROID_MCP_ALLOW_WRITE`	❌	`false`	Enable write operations (install, tap, push)
`ANDROID_MCP_ALLOW_SHELL`	❌	`false`	Enable arbitrary `adb shell` execution
`ANDROID_TOOLS`	❌	—	Comma-sep allowlist of categories. Biggest token saver.
`ANDROID_DISABLE`	❌	—	Comma-sep denylist. Ignored when `ANDROID_TOOLS` is set.
`MCP_TRANSPORT`	❌	`stdio`	`http` to enable Streamable HTTP transport
`MCP_HTTP_TOKEN`	conditional	—	Bearer token. Required when `MCP_TRANSPORT=http`
`MCP_HTTP_PORT`	❌	`3000`	HTTP listen port
`MCP_HTTP_HOST`	❌	`127.0.0.1`	HTTP bind host (DNS rebinding protection auto-enabled for localhost)
`MCP_HTTP_SKIP_AUTH`	❌	`false`	Skip Bearer auth — e.g. behind a reverse proxy that handles it

Categories (9): device, apps, ui, logcat, emulator, files, system, debug, shell (always-gated by ANDROID_MCP_ALLOW_SHELL), plus always-on meta.

When MCP_TRANSPORT=http: POST /mcp (Bearer-auth JSON-RPC) + GET /health (public liveness).

Token efficiency

Scenario	Tools	Schema tokens	vs default
default (all categories)	76	9,200	—
typical (`ANDROID_TOOLS=device,ui,apps,logcat`)	37	5,000	−46%
narrow (`ANDROID_TOOLS=device,ui`)	19	2,500	−73%

Plus search-tools meta-tool (always enabled) for runtime tool discovery.

Read-only mode (default)

By default, only read operations are permitted. Write operations (tap, install-app, push-file, etc.) return an error unless ANDROID_MCP_ALLOW_WRITE=true. Shell command execution requires a separate ANDROID_MCP_ALLOW_SHELL=true for additional security — even with write enabled, raw shell stays blocked unless this is explicitly set.

MCP Prompts (5)

Workflow templates available via MCP prompts/list:

crash-investigation — pull crash logs + stack frames + recent permission changes for a target package.
memory-leak-detection — track heap delta over a window; cluster by allocator.
ui-element-locator — find a UI element by visual + accessibility hints; return tap coordinates.
app-startup-profile — cold-start profile: activity launch + fragment init + first frame.
permission-audit — flag dangerous permissions held by under-used 3rd-party apps.

MCP Resources

URI-based read-only entities:

android://devices — connected devices
android://device/{serial} — device details (model/brand/version/display)
android://app/{packageName}/activities — activities exposed by a package (exported/launchable flags)
android://device/{serial}/processes — running processes

Tools (76)

9 categories. Use search-tools to discover at runtime; full list collapsed below.

Category	Tools
System (battery / network / settings / display / orientation / port-fwd / wifi / mobile-data)	19
Apps (install / launch / permissions / intents / data clear)	14
UI (tap / swipe / screenshot / hierarchy / accessibility / annotated tap-by-index / screen recording)	14
Emulator (AVD start/stop, snapshot mgmt)	7
Device (list / info / properties / wireless connect)	5
Debug (bugreport / mem / gfx / cpu / doctor)	5
Logcat (capture / filter / clear / crash extract)	4
Files (list / pull / push / delete)	4
Shell (gated `execute-shell`)	1
Aggregations (`device-health`, `analyze-app`)	2
Meta (`search-tools`)	1

Device (5)

list-devices, get-device-info, get-device-properties, connect-device, disconnect-device

Apps (14)

list-packages, get-package-info, install-app, uninstall-app, launch-app, stop-app, clear-app-data, grant-permission, revoke-permission, open-url, send-broadcast, get-current-activity, is-app-installed, get-app-intents

UI Automation (14)

take-screenshot, dump-ui-hierarchy, ui-snapshot-a11y, tap, long-press, swipe, input-text, press-key, drag-and-drop, start-screen-recording, pull-screen-recording, double-tap, take-annotated-screenshot, tap-element

Logcat (4)

get-logcat, clear-logcat, search-logcat, get-crash-logs

Emulator (7)

list-avds, start-emulator, stop-emulator, list-snapshots, load-snapshot, save-snapshot, delete-snapshot

Files (4)

list-files, pull-file, push-file, delete-file

System (19)

get-battery-info, get-network-info, change-setting, get-setting, set-display-size, set-display-density, keep-screen-on, port-forward, reverse-forward, list-forwards, remove-forward, toggle-wifi, toggle-mobile-data, open-notification, lock-device, unlock-device, get-orientation, set-orientation, list-settings

Debug (5)

bugreport, get-mem-info, get-gfx-info, get-cpu-info, doctor

Shell (1)

execute-shell — gated by ANDROID_MCP_ALLOW_SHELL

Aggregations

device-health — battery + memory + cpu + network in one call (~7KB response, 4 sub-systems with caveats). analyze-app — package info + memory + activities aggregation.

Architecture

Claude → MCP stdio → src/index.ts
                      ├── adb.ts (execFile wrapper)
                      ├── tools/utils.ts (wrapToolHandler, shellEscape, validation)
                      └── tools/{device,apps,ui,logcat,emulator,files,system,debug,shell,aggregations}.ts
                                  ↓
                          ADB CLI (USB / TCP-IP / Emulator)
                                  ↓
                          Android Device

Built on @us-all/mcp-toolkit:

extractFields — token-efficient response projections (skipped for ADB flat-array endpoints)
aggregate(fetchers, caveats) — fan-out helper for device-health / analyze-app
createWrapToolHandler — WriteBlockedError/ShellBlockedError passthrough + structured ADB errors ({code, stderr})
wrapImageToolHandler (Android-only) — base64 PNG sanitization
search-tools meta-tool

Security

Read-only by default. Writes blocked without ANDROID_MCP_ALLOW_WRITE=true.
Shell gating separate. execute-shell blocked without ANDROID_MCP_ALLOW_SHELL=true even with write enabled — distinct trust levels.
Shell injection safe. shellEscape for single-quote-based escape; input validation via zod regex whitelists for setting keys, package names, permissions, components, broadcast actions/extras.
Path-traversal blocked. Device paths require absolute + no .. + no shell metachars.
Error sanitization. API keys, tokens, passwords redacted from all error outputs.

Tech stack

Node.js 22+ • TypeScript strict ESM • pnpm 10 • @modelcontextprotocol/sdk 1.29+ • zod v4 • fast-xml-parser • vitest (fork pool isolation).

License

MIT

Adicionar este servidor

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Android?

Does Android need an API key?

What transport does Android use?

When was Android last checked?

Documentation

Android MCP Server

What it does that others don't

Try this — 5 prompts

When to use this vs mobile-next/mobile-mcp

Install

Claude Desktop

Claude Code

Docker

Build from source

Prerequisites

Configuration

Token efficiency

Read-only mode (default)

MCP Prompts (5)

MCP Resources

Tools (76)

Device (5)

Apps (14)

UI Automation (14)

Logcat (4)

Emulator (7)

Files (4)

System (19)

Debug (5)

Shell (1)

Aggregations

Meta

Architecture

Security

Tech stack

License