# android

Inspects Android hardware and emulators through direct ADB commands. Gathers logs, memory traces, and crash details inside your AI workspace.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Author: us-all
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/us-all/android-mcp-server
- Updated: 2026-07-10
- HTML: https://affpapa.org/en/nevibecode/mcp/us-all-android

## What it does

The server exposes 76 diagnostic utilities covering logcat, package metadata, system properties, and running processes. It avoids external test frameworks like Appium or uiautomator2. Official ADB commands run directly via Node.js sub-processes.

Built-in prompts handle crash extraction and memory audits. Composite calls like `device-health` return battery and memory metrics together. Tools are organized across 9 groups, which you can selectively filter with `ANDROID_TOOLS` or `ANDROID_DISABLE` to keep context windows compact.

Write actions remain disabled by default. You need a working ADB executable on your system path and active USB debugging. State modifications and terminal access require enabling `ANDROID_MCP_ALLOW_WRITE` and `ANDROID_MCP_ALLOW_SHELL`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ADB_PATH`, `ANDROID_HOME`, `ANDROID_SERIAL`, `ANDROID_TOOLS`, `ANDROID_DISABLE`, `ANDROID_MCP_ALLOW_SHELL`, `ANDROID_MCP_ALLOW_WRITE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ADB_PATH=<ADB_PATH> --env ANDROID_HOME=<ANDROID_HOME> --env ANDROID_SERIAL=<ANDROID_SERIAL> --env ANDROID_TOOLS=<ANDROID_TOOLS> --env ANDROID_DISABLE=<ANDROID_DISABLE> --transport stdio us-all-android -- npx -y @us-all/android-mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add us-all-android --env ADB_PATH=<ADB_PATH> --env ANDROID_HOME=<ANDROID_HOME> --env ANDROID_SERIAL=<ANDROID_SERIAL> --env ANDROID_TOOLS=<ANDROID_TOOLS> --env ANDROID_DISABLE=<ANDROID_DISABLE> -- npx -y @us-all/android-mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "us-all-android": {
            "command": "npx",
            "args": [
                "-y",
                "@us-all/android-mcp"
            ],
            "env": {
                "ADB_PATH": "<ADB_PATH>",
                "ANDROID_HOME": "<ANDROID_HOME>",
                "ANDROID_SERIAL": "<ANDROID_SERIAL>",
                "ANDROID_TOOLS": "<ANDROID_TOOLS>",
                "ANDROID_DISABLE": "<ANDROID_DISABLE>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "us-all-android": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@us-all/android-mcp"
            ],
            "env": {
                "ADB_PATH": "<ADB_PATH>",
                "ANDROID_HOME": "<ANDROID_HOME>",
                "ANDROID_SERIAL": "<ANDROID_SERIAL>",
                "ANDROID_TOOLS": "<ANDROID_TOOLS>",
                "ANDROID_DISABLE": "<ANDROID_DISABLE>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ADB_PATH=<ADB_PATH> -e ANDROID_HOME=<ANDROID_HOME> -e ANDROID_SERIAL=<ANDROID_SERIAL> -e ANDROID_TOOLS=<ANDROID_TOOLS> -e ANDROID_DISABLE=<ANDROID_DISABLE> us-all-android npx -y @us-all/android-mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

## When to use it
- extract crash stack traces from logcat output
- track heap allocations and detect memory leaks
- audit sensitive permissions granted to installed packages
- measure cold-start duration and launch timings for app activities

## Example prompts
- Inspect the latest crash on the active emulator and extract the stack trace for com.example.app.
- Run device-health to inspect memory, CPU load, and battery status on the connected phone.
- Audit third-party applications holding camera and location access.

## Similar
- [orca-emulator-android](https://affpapa.org/en/nevibecode/skills/orca-emulator-android.md) — skill · 5600 installs
- [android-emulator-qa](https://affpapa.org/en/nevibecode/skills/android-emulator-qa.md) — skill · 308 installs
- [adb-mcp: Android emulator and device control over adb](https://affpapa.org/en/nevibecode/mcp/adb-mcp-android-emulator-and-device-control-over-adb.md) — MCP server · ★ 11
- [test-android-apps](https://affpapa.org/en/nevibecode/plugins/test-android-apps.md) — plugin · ★ 7604
- [limrun-android-emulator](https://affpapa.org/en/nevibecode/skills/limrun-android-emulator.md) — skill · 38700 installs
- [Oh My Android](https://affpapa.org/en/nevibecode/mcp/oh-my-android.md) — MCP server · ★ 69

## Other versions with the same name
- [android · martingeidobler](https://affpapa.org/en/nevibecode/mcp/android.md) — ★ 68

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md