Conectándose a Android usando MCP

Instalar Android-MCP en un venv y registrarlo en claude-code

Introducción

Android-MCP es un servidor MCP que permite a Claude operar un dispositivo Android como lo haría un usuario real: tocar la pantalla, escribir texto, hacer swipes, leer notificaciones y tomar snapshots de la interfaz.

La idea es simple: el teléfono queda conectado por ADB y el MCP expone esas acciones como herramientas. Desde claude-code se puede entonces pedir cosas como "abrí la app de mensajes y mandame el último chat" sin tocar el dispositivo.

Instalando Android-MCP

Lo primero es crear un entorno virtual aislado:

python3.13 -m venv ~/.venvs/android-mcp

Decidí usar la carpeta ~/.venvs/ para instalar el MCP porque así todos los servidores MCP quedan en un mismo lugar, cada uno en su propio venv. Nada se mezcla con el Python del sistema, no hay conflictos de dependencias entre servidores, y si algo se rompe basta con borrar la carpeta y volver a crearla. También hace que la ruta al binario sea predecible, que es justo lo que necesitamos después para registrarlo.

Luego instalamos el paquete (y actualizamos pip en el mismo paso):

~/.venvs/android-mcp/bin/pip install --upgrade pip android-mcp

Notar que se invoca el pip del venv por ruta absoluta, sin activarlo. Es menos pasos y evita olvidarse de que el entorno quedó activado.

Para testear que el MCP funciona:

~/.venvs/android-mcp/bin/android-mcp --help      # smoke test

Si devuelve la ayuda del comando, el binario está instalado y ejecutable. Ese es todo el smoke test que necesitamos antes de registrarlo.

Agregando el MCP a claude-code

claude mcp add android-mcp --scope user -- "$HOME/.venvs/android-mcp/bin/android-mcp"

Detalles de ese comando:

  • --scope user lo registra a nivel usuario, así está disponible en todos los proyectos y no sólo en el directorio actual.
  • El -- separa las opciones de claude mcp add del comando real a ejecutar.
  • Se usa $HOME en lugar de ~ porque dentro de las comillas la tilde no se expande.

Después de esto, reiniciar claude-code y las herramientas de Android deberían aparecer disponibles (ListDevices, ConnectDevice, Snapshot, Click, Type, Swipe, etc.). Un buen primer paso es pedir la lista de dispositivos para confirmar que el teléfono está visible por ADB.