Let AI agents see and control an Android phone over ADB, with safety guards.
Connect Runs on your machine
claude mcp add android-use -e ADB_SERIAL=<ADB_SERIAL> -e ALLOW_SHELL=<ALLOW_SHELL> -e ALLOW_SENSITIVE=<ALLOW_SENSITIVE> -e SENSITIVE_PACKAGES=<SENSITIVE_PACKAGES> -e RATE_LIMIT_PER_MIN=<RATE_LIMIT_PER_MIN> -e ADB_PATH=<ADB_PATH> -- npx -y @ghostfacemodz/[email protected]{
"mcpServers": {
"android-use": {
"command": "npx",
"args": [
"-y",
"@ghostfacemodz/[email protected]"
],
"env": {
"ADB_SERIAL": "<ADB_SERIAL>",
"ALLOW_SHELL": "<ALLOW_SHELL>",
"ALLOW_SENSITIVE": "<ALLOW_SENSITIVE>",
"SENSITIVE_PACKAGES": "<SENSITIVE_PACKAGES>",
"RATE_LIMIT_PER_MIN": "<RATE_LIMIT_PER_MIN>",
"ADB_PATH": "<ADB_PATH>"
}
}
}
}{
"mcpServers": {
"android-use": {
"command": "npx",
"args": [
"-y",
"@ghostfacemodz/[email protected]"
],
"env": {
"ADB_SERIAL": "<ADB_SERIAL>",
"ALLOW_SHELL": "<ALLOW_SHELL>",
"ALLOW_SENSITIVE": "<ALLOW_SENSITIVE>",
"SENSITIVE_PACKAGES": "<SENSITIVE_PACKAGES>",
"RATE_LIMIT_PER_MIN": "<RATE_LIMIT_PER_MIN>",
"ADB_PATH": "<ADB_PATH>"
}
}
}
}{
"servers": {
"android-use": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ghostfacemodz/[email protected]"
],
"env": {
"ADB_SERIAL": "<ADB_SERIAL>",
"ALLOW_SHELL": "<ALLOW_SHELL>",
"ALLOW_SENSITIVE": "<ALLOW_SENSITIVE>",
"SENSITIVE_PACKAGES": "<SENSITIVE_PACKAGES>",
"RATE_LIMIT_PER_MIN": "<RATE_LIMIT_PER_MIN>",
"ADB_PATH": "<ADB_PATH>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
ADB_SERIALOptional | Comma-separated allowlist of device serials (from `adb devices`). Recommended. |
ALLOW_SHELLOptional | Set to 1 to register the raw `shell` tool (off by default). |
ALLOW_SENSITIVEOptional | Set to 1 to disable the banking/payments/messaging app guard (off by default). |
SENSITIVE_PACKAGESOptional | Extra comma-separated package names to treat as sensitive. |
RATE_LIMIT_PER_MINOptional | Maximum tool calls per minute (default 120). |
ADB_PATHOptional | Path to the adb binary if it is not on PATH. |
Details
| Package | @ghostfacemodz/[email protected] (NPM, stdio) |
| First published | 20 Oct 2026 |
| Last updated | 20 Oct 2026 |
| Registry name | io.github.GhostFaceModz/android-use |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.