# android-adb-mcp

MCP server for Android device management via ADB. Lets Claude Code on your laptop inspect and configure an Android device over USB or Wi-Fi ADB.

## Prerequisites

- `adb` installed on your laptop (`brew install android-platform-tools`)
- Android device with **Developer Options → USB Debugging** (or **Wireless Debugging**) enabled
- Node.js 18+

## Setup

```bash
npm install
npm run build
```

Connect your device:
```bash
# USB
adb devices

# Wi-Fi (Android 11+)
adb connect <device-ip>:5555
```

## Claude Code integration

Add to `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "android": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/android-adb-mcp/dist/index.js"]
    }
  }
}
```

## Available tools

| Tool | Description |
|------|-------------|
| `list_devices` | List connected devices |
| `device_info` | Model, Android version, battery |
| `list_apps` | List apps (all/user/system/disabled) |
| `app_info` | Permissions, version, storage for an app |
| `clear_app_cache` | Clear cache for one app |
| `clear_all_caches` | Clear cache for all user apps |
| `disable_app` | Disable an app without uninstalling |
| `enable_app` | Re-enable a disabled app |
| `force_stop_app` | Force stop a running app |
| `list_notifications` | Active notifications |
| `set_app_notifications` | Allow/deny notifications per app |
| `set_heads_up_notifications` | Toggle global heads-up notifications |
| `audit_permissions` | All appops permissions for an app |
| `revoke_permission` | Revoke a runtime permission |
| `security_violations` | SELinux denials and SecurityExceptions |
| `device_policy_state` | MDM / device policy config |
| `battery_hogs` | Per-app battery usage |
| `memory_usage` | Memory by process |
| `data_usage` | Per-app mobile data usage |
| `get_setting` | Read system/global/secure setting |
| `set_setting` | Write system/global/secure setting |
| `disable_animations` | Disable UI animations |
| `network_info` | WiFi and connectivity state |