Google Admin MCP

Servidor MCP do Google Admin

Um servidor FastMCP para gerenciar usuários do Google Workspace por meio da API Admin Directory.

Recursos

• Listar usuários em um domínio
• Criar novos usuários com senhas aleatórias seguras
• Obter informações detalhadas do usuário
• Suspender e reativar usuários

Pré-requisitos

• Docker
• Conta de administrador do Google Workspace
• API Admin Directory do Google habilitada
• Token OAuth2 codificado em Base64 na variável de ambiente GOOGLE_TOKEN_JSON

Instalação

1. Clone o repositório
2. Crie a imagem Docker:

docker build -t google-admin-mcp .

Executando o Servidor

Execute o contêiner:

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

Ferramentas Disponíveis

listUsers

Lista usuários em um domínio.

{
  "domain": "yourdomain.com"
}

addUser

Cria um novo usuário com uma senha aleatória segura.

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

getUser

Obtém informações detalhadas sobre um usuário específico.

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

suspendUser

Suspende uma conta de usuário.

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

unsuspendUser

Reativa uma conta de usuário.

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

Notas de Segurança

• Todos os usuários criados serão obrigados a alterar a senha no primeiro login
• As senhas são geradas com segurança, contendo:
  • Mínimo de 12 caracteres
  • Letras maiúsculas e minúsculas
  • Números
  • Caracteres especiais
• O servidor requer um token OAuth2 válido com os escopos apropriados da API Admin Directory

Tratamento de Erros

O servidor fornece mensagens de erro claras para:

• Falhas de autenticação
• Parâmetros inválidos
• Erros de API
• Variáveis de ambiente ausentes

Licença

Licença MIT