Skip to content
VS Code

NexusAndroid for VS Code

io.github.pironjulien/nexus-android

Android computer use over plain ADB: screen, gestures, SMS, notifications, files. No root, no app.

client:VS Code transport:stdio runtime:pypi

Install NexusAndroid in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "nexus-android-adb",
      "description": "NEXUS_ANDROID_ADB",
      "password": true
    },
    {
      "type": "promptString",
      "id": "nexus-android-serial",
      "description": "NEXUS_ANDROID_SERIAL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "nexus-android-keep-awake",
      "description": "NEXUS_ANDROID_KEEP_AWAKE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "nexus-android-awake-idle",
      "description": "NEXUS_ANDROID_AWAKE_IDLE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "nexus-android-adb-download",
      "description": "NEXUS_ANDROID_ADB_DOWNLOAD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "nexus-android-update",
      "description": "NEXUS_ANDROID_UPDATE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "nexus-android-managed",
      "description": "NEXUS_ANDROID_MANAGED",
      "password": true
    }
  ],
  "servers": {
    "nexus-android": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nexus-android"
      ],
      "env": {
        "NEXUS_ANDROID_ADB": "${input:nexus-android-adb}",
        "NEXUS_ANDROID_SERIAL": "${input:nexus-android-serial}",
        "NEXUS_ANDROID_KEEP_AWAKE": "${input:nexus-android-keep-awake}",
        "NEXUS_ANDROID_AWAKE_IDLE": "${input:nexus-android-awake-idle}",
        "NEXUS_ANDROID_ADB_DOWNLOAD": "${input:nexus-android-adb-download}",
        "NEXUS_ANDROID_UPDATE": "${input:nexus-android-update}",
        "NEXUS_ANDROID_MANAGED": "${input:nexus-android-managed}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

NexusAndroid in other clients