MCP server
MCP Android
Control Android devices over ADB from AI agents — safe-by-default, read-only by default…
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- 5 days ago
About MCP Android
MCP Android is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Control Android devices over ADB from AI agents — safe-by-default, read-only by default, audited.
Install
Run in a terminal
claude mcp add mcp-android -- npx -y @dockndevai/mcp-androidAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-android": {
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-android"
]
}
}
}Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-android": {
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-android"
]
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"mcp-android": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-android"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-android": {
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-android"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-android": {
"command": "npx",
"args": [
"-y",
"@dockndevai/mcp-android"
]
}
}
}Configuration
ANDROID_MODEAccess mode: read-only | read-write | admin.ANDROID_ADB_PATHPath to the adb binary (default: adb on PATH).ANDROID_SERIALTarget device serial from `adb devices`. Empty = the only connected device.ANDROID_TIMEOUT_MSPer-command adb timeout in milliseconds.ANDROID_PACKAGE_ALLOWLISTComma-separated package allowlist for launch/uninstall/clear. Empty = all.ANDROID_PROTECTED_PACKAGESPackages that can be launched/inspected but never uninstalled or data-cleared.ANDROID_ALLOW_INSTALLEnable install_apk / uninstall_app / clear_app_data (requires admin mode too).ANDROID_ALLOW_SHELLEnable run_shell (arbitrary adb shell; requires admin mode too).ANDROID_DRY_RUNValidate + log write/admin actions without executing them on the device.ANDROID_AUDIT_LOGEmit a JSON audit line to stderr per guarded operation (default true).
Pricing
Open source
MCP Android FAQ
Is MCP Android free?
Yes. MCP Android is open source, so you can use and self-host it for free.
How do I add MCP Android to Claude Code?
Run this command in your terminal: claude mcp add mcp-android -- npx -y @dockndevai/mcp-android