google-admin-automation

Google Workspace Admin Automation via Rube MCP

Verwalte Google Workspace-Benutzer, -Gruppen, -Mitgliedschaften und -Organisationseinstellungen programmatisch über Rube MCP (Composio).

Toolkit-Dokumentation: composio.dev/toolkits/google_admin

Voraussetzungen

• Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
• Aktive Verbindung über RUBE_MANAGE_CONNECTIONS mit dem Toolkit google_admin
• Google Workspace-Administratorrechte für das authentifizierte Konto
• Rufe immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemas zu erhalten

Einrichtung

Rube MCP holen: Füge https://rube.app/mcp als MCP-Server in deiner Client-Konfiguration hinzu. Keine API-Schlüssel erforderlich – füge einfach den Endpunkt hinzu, und es funktioniert.

1. Überprüfe, ob Rube MCP verfügbar ist, indem du bestätigst, dass RUBE_SEARCH_TOOLS antwortet
2. Rufe RUBE_MANAGE_CONNECTIONS mit dem Toolkit google_admin auf
3. Falls die Verbindung nicht AKTIV ist, folge dem zurückgegebenen Authentifizierungslink, um die Einrichtung abzuschließen
4. Bestätige, dass der Verbindungsstatus AKTIV anzeigt, bevor du Workflows ausführst

Kern-Workflows

1. Alle Benutzer auflisten

Verwende GOOGLE_ADMIN_LIST_USERS, um Google Workspace-Benutzer mit optionaler Filterung und Paginierung abzurufen.

Tool: GOOGLE_ADMIN_LIST_USERS
Parameter:
  - customer: Kundennummer oder "my_customer" (Standard)
  - domain: Domäne, aus der Benutzer aufgelistet werden sollen
  - query: Filterzeichenfolge (z. B. "orgName=Engineering", "isSuspended=false")
  - max_results: Maximale Ergebnisse (1-500, Standard 100)
  - order_by: Sortieren nach "email", "givenName" oder "familyName"
  - sort_order: "ASCENDING" oder "DESCENDING"
  - page_token: Paginierungs-Token

2. Neuen Benutzer erstellen

Verwende GOOGLE_ADMIN_CREATE_USER, um ein neues Google Workspace-Konto bereitzustellen.

Tool: GOOGLE_ADMIN_CREATE_USER
Parameter:
  - primary_email (erforderlich): E-Mail des Benutzers (z. B. "[email protected]")
  - given_name (erforderlich): Vorname
  - family_name (erforderlich): Nachname
  - password (erforderlich): Passwort, das den Domänenanforderungen entspricht
  - org_unit_path: Organisationseinheit (Standard: "/")
  - change_password_at_next_login: Passwortänderung erzwingen (Standard: true)
  - recovery_email: Wiederherstellungs-E-Mail-Adresse
  - recovery_phone: Wiederherstellungs-Telefonnummer
  - suspended: Ob das Konto gesperrt startet (Standard: false)

3. Gruppen auflisten und verwalten

Verwende GOOGLE_ADMIN_LIST_GROUPS zum Auflisten von Gruppen und GOOGLE_ADMIN_CREATE_GROUP zum Erstellen neuer Gruppen.

Tool: GOOGLE_ADMIN_LIST_GROUPS
Parameter:
  - customer: "my_customer" (Standard)
  - domain: Nach Domäne filtern
  - query: Filter (z. B. "name=Engineering*")
  - max_results: Maximale Ergebnisse (1-200)
  - order_by: Sortieren nach "email"
  - page_token: Paginierungs-Token

Tool: GOOGLE_ADMIN_CREATE_GROUP
Parameter:
  - email (erforderlich): Gruppen-E-Mail-Adresse (z. B. "[email protected]")
  - name (erforderlich): Anzeigename (z. B. "Engineering-Team")
  - description: Beschreibung des Gruppenzwecks

4. Benutzer zu Gruppen hinzufügen

Verwende GOOGLE_ADMIN_ADD_USER_TO_GROUP, um Gruppenmitgliedschaften zu verwalten.

Tool: GOOGLE_ADMIN_ADD_USER_TO_GROUP
Parameter:
  - group_key (erforderlich): Gruppen-E-Mail oder -ID
  - user_key (erforderlich): Benutzer-E-Mail oder -ID
  - role: "MEMBER" (Standard), "MANAGER" oder "OWNER"

5. Benutzer sperren oder entsperren

Verwende GOOGLE_ADMIN_SUSPEND_USER, um die Sperrung eines Benutzerkontos umzuschalten.

Tool: GOOGLE_ADMIN_SUSPEND_USER
Parameter:
  - user_key (erforderlich): E-Mail oder eindeutige ID des Benutzers
  - suspended: true zum Sperren, false zum Entsperren (Standard: true)
  - suspension_reason: Grund für die Sperrung (optional)

6. Benutzer- oder Gruppendetails abrufen

Verwende GOOGLE_ADMIN_GET_USER oder GOOGLE_ADMIN_GET_GROUP, um detaillierte Informationen abzurufen.

Tool: GOOGLE_ADMIN_GET_USER
Parameter:
  - user_key (erforderlich): E-Mail oder eindeutige ID des Benutzers

Tool: GOOGLE_ADMIN_GET_GROUP
Parameter:
  - group_key (erforderlich): E-Mail oder eindeutige ID der Gruppe

Häufige Muster

• Onboarding-Workflow: Verwende GOOGLE_ADMIN_CREATE_USER, um das Konto bereitzustellen, dann GOOGLE_ADMIN_ADD_USER_TO_GROUP, um den Benutzer zu relevanten Gruppen hinzuzufügen.
• Offboarding-Workflow: Verwende GOOGLE_ADMIN_SUSPEND_USER, um den Zugriff zu deaktivieren, oder GOOGLE_ADMIN_DELETE_USER für die dauerhafte Entfernung.
• Gruppenmitgliedschaft prüfen: Verwende GOOGLE_ADMIN_LIST_GROUPS, um Gruppen zu finden, dann GOOGLE_ADMIN_LIST_GROUP_MEMBERS, um die Mitglieder zu überprüfen.
• Massenverwaltung von Benutzern: Liste Benutzer mit GOOGLE_ADMIN_LIST_USERS und Filterabfragen auf, dann iteriere für Aktualisierungen.
• E-Mail-Aliase hinzufügen: Verwende GOOGLE_ADMIN_ADD_USER_ALIAS, um alternative E-Mail-Adressen für einen Benutzer hinzuzufügen.
• Benutzerdetails nachschlagen: Verwende GOOGLE_ADMIN_GET_USER, um vollständige Profilinformationen abzurufen, bevor du Änderungen vornimmst.

Bekannte Fallstricke

• Administratorrechte erforderlich: Alle Tools setzen voraus, dass der authentifizierte Benutzer Google Workspace-Administratorrechte besitzt. Nicht-Admin-Konten erhalten Berechtigungsfehler.
• Löschen ist endgültig: GOOGLE_ADMIN_DELETE_USER entfernt ein Benutzerkonto dauerhaft. Diese Aktion kann nicht rückgängig gemacht werden.
• user_key akzeptiert E-Mail oder ID: Der Parameter user_key akzeptiert sowohl die primäre E-Mail-Adresse des Benutzers als auch seine eindeutige numerische Benutzer-ID.
• Gruppenmitgliedschaft ersetzt: Beim Hinzufügen zu Gruppen steuert der Parameter role die Rolle des Mitglieds. Es gibt keine „Rolle aktualisieren“ – entfernen und erneut hinzufügen, um die Rolle zu ändern.
• Kundennummer: Verwende "my_customer" als Parameter customer für die Organisation des authentifizierten Benutzers. Spezifische Kundennummern sehen aus wie C01abc123.
• Paginierung: Sowohl Benutzer- als auch Gruppenlisten-Endpunkte können paginierte Ergebnisse liefern. Überprüfe in den Antworten immer auf page_token für vollständige Ergebnisse.
• Passwortanforderungen: GOOGLE_ADMIN_CREATE_USER erfordert ein Passwort, das der Passwortrichtlinie der Domäne entspricht. Schwache Passwörter werden abgelehnt.

Kurzreferenz

Aktion	Tool	Wichtige Parameter
Benutzer auflisten	GOOGLE_ADMIN_LIST_USERS	customer, domain, query, max_results
Benutzerdetails abrufen	GOOGLE_ADMIN_GET_USER	user_key
Benutzer erstellen	GOOGLE_ADMIN_CREATE_USER	primary_email, given_name, family_name, password
Benutzer löschen	GOOGLE_ADMIN_DELETE_USER	user_key
Benutzer sperren	GOOGLE_ADMIN_SUSPEND_USER	user_key, suspended
Benutzer-Alias hinzufügen	GOOGLE_ADMIN_ADD_USER_ALIAS	(vollständiges Schema via RUBE_SEARCH_TOOLS anzeigen)
Gruppen auflisten	GOOGLE_ADMIN_LIST_GROUPS	customer, domain, query
Gruppendetails abrufen	GOOGLE_ADMIN_GET_GROUP	group_key
Gruppe erstellen	GOOGLE_ADMIN_CREATE_GROUP	email, name, description
Zur Gruppe hinzufügen	GOOGLE_ADMIN_ADD_USER_TO_GROUP	group_key, user_key, role
Gruppenmitglieder auflisten	GOOGLE_ADMIN_LIST_GROUP_MEMBERS	(vollständiges Schema via RUBE_SEARCH_TOOLS anzeigen)

---

Powered by Composio