Automação do Google Workspace Admin via Rube MCP

Gerencie usuários, grupos, associações e configurações organizacionais do Google Workspace programaticamente usando Rube MCP (Composio).

Documentação do Toolkit: composio.dev/toolkits/google_admin

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa via RUBE_MANAGE_CONNECTIONS com o toolkit google_admin
• Privilégios de administrador do Google Workspace para a conta autenticada
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit google_admin
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar Todos os Usuários

Use GOOGLE_ADMIN_LIST_USERS para recuperar usuários do Google Workspace com filtragem e paginação opcionais.

Tool: GOOGLE_ADMIN_LIST_USERS
Parameters:
  - customer: Customer ID or "my_customer" (default)
  - domain: Domain to list users from
  - query: Filter string (e.g., "orgName=Engineering", "isSuspended=false")
  - max_results: Maximum results (1-500, default 100)
  - order_by: Sort by "email", "givenName", or "familyName"
  - sort_order: "ASCENDING" or "DESCENDING"
  - page_token: Pagination token

2. Criar um Novo Usuário

Use GOOGLE_ADMIN_CREATE_USER para provisionar uma nova conta do Google Workspace.

Tool: GOOGLE_ADMIN_CREATE_USER
Parameters:
  - primary_email (required): User's email (e.g., "john.doe@company.com")
  - given_name (required): First name
  - family_name (required): Last name
  - password (required): Password meeting domain requirements
  - org_unit_path: Organizational unit (default: "/")
  - change_password_at_next_login: Force password change (default: true)
  - recovery_email: Recovery email address
  - recovery_phone: Recovery phone number
  - suspended: Whether account starts suspended (default: false)

3. Listar e Gerenciar Grupos

Use GOOGLE_ADMIN_LIST_GROUPS para listar grupos e GOOGLE_ADMIN_CREATE_GROUP para criar novos.

Tool: GOOGLE_ADMIN_LIST_GROUPS
Parameters:
  - customer: "my_customer" (default)
  - domain: Filter by domain
  - query: Filter (e.g., "name=Engineering*")
  - max_results: Max results (1-200)
  - order_by: Sort by "email"
  - page_token: Pagination token

Tool: GOOGLE_ADMIN_CREATE_GROUP
Parameters:
  - email (required): Group email address (e.g., "engineering@company.com")
  - name (required): Display name (e.g., "Engineering Team")
  - description: Group purpose description

4. Adicionar Usuários a Grupos

Use GOOGLE_ADMIN_ADD_USER_TO_GROUP para gerenciar a associação a grupos.

Tool: GOOGLE_ADMIN_ADD_USER_TO_GROUP
Parameters:
  - group_key (required): Group email or ID
  - user_key (required): User email or ID to add
  - role: "MEMBER" (default), "MANAGER", or "OWNER"

5. Suspender ou Reativar Usuários

Use GOOGLE_ADMIN_SUSPEND_USER para alternar a suspensão da conta do usuário.

Tool: GOOGLE_ADMIN_SUSPEND_USER
Parameters:
  - user_key (required): User's email or unique ID
  - suspended: true to suspend, false to unsuspend (default: true)
  - suspension_reason: Reason for suspension (optional)

6. Obter Detalhes de Usuário ou Grupo

Use GOOGLE_ADMIN_GET_USER ou GOOGLE_ADMIN_GET_GROUP para recuperar informações detalhadas.

Tool: GOOGLE_ADMIN_GET_USER
Parameters:
  - user_key (required): User's email or unique ID

Tool: GOOGLE_ADMIN_GET_GROUP
Parameters:
  - group_key (required): Group's email or unique ID

Padrões Comuns

• Fluxo de trabalho de integração (onboarding): Use GOOGLE_ADMIN_CREATE_USER para provisionar a conta e, em seguida, GOOGLE_ADMIN_ADD_USER_TO_GROUP para adicioná-los aos grupos relevantes.
• Fluxo de trabalho de desativação (offboarding): Use GOOGLE_ADMIN_SUSPEND_USER para desabilitar o acesso ou GOOGLE_ADMIN_DELETE_USER para remoção permanente.
• Auditar associação a grupos: Use GOOGLE_ADMIN_LIST_GROUPS para encontrar grupos e, em seguida, GOOGLE_ADMIN_LIST_GROUP_MEMBERS para revisar membros.
• Gerenciamento em massa de usuários: Liste usuários com GOOGLE_ADMIN_LIST_USERS e filtre consultas, em seguida, itere para atualizações.
• Adicionar aliases de e-mail: Use GOOGLE_ADMIN_ADD_USER_ALIAS para adicionar endereços de e-mail alternativos para um usuário.

…