Google Admin MCP

Servidor MCP de Google Admin

Un servidor FastMCP para gestionar usuarios de Google Workspace a través de la API de Admin Directory.

Características

• Listar usuarios en un dominio
• Crear nuevos usuarios con contraseñas aleatorias seguras
• Obtener información detallada de usuarios
• Suspender y reactivar usuarios

Requisitos previos

• Docker
• Cuenta de administrador de Google Workspace
• API de Admin Directory de Google habilitada
• Token OAuth2 codificado en Base64 en la variable de entorno GOOGLE_TOKEN_JSON

Instalación

1. Clona el repositorio
2. Construye la imagen de Docker:

docker build -t google-admin-mcp .

Ejecutar el servidor

Ejecuta el contenedor:

docker run -e GOOGLE_TOKEN_JSON="your_base64_encoded_token" google-admin-mcp

Herramientas disponibles

listUsers

Lista los usuarios en un dominio.

{
  "domain": "yourdomain.com"
}

addUser

Crea un nuevo usuario con una contraseña aleatoria segura.

{
  "primaryEmail": "user@yourdomain.com",
  "firstName": "First",
  "lastName": "Last"
}

getUser

Obtiene información detallada sobre un usuario específico.

{
  "userKey": "user@yourdomain.com"
}

suspendUser

Suspende una cuenta de usuario.

{
  "userKey": "user@yourdomain.com"
}

unsuspendUser

Reactiva una cuenta de usuario.

{
  "userKey": "user@yourdomain.com"
}

Notas de seguridad

• Todos los usuarios creados deberán cambiar su contraseña en el primer inicio de sesión
• Las contraseñas se generan de forma segura con:
  • Mínimo 12 caracteres
  • Letras mayúsculas y minúsculas
  • Números
  • Caracteres especiales
• El servidor requiere un token OAuth2 válido con los alcances apropiados de la API de Admin Directory

Manejo de errores

El servidor proporciona mensajes de error claros para:

• Fallos de autenticación
• Parámetros no válidos
• Errores de API
• Variables de entorno faltantes

Licencia

Licencia MIT