Manage Google Group Members
Add or remove users from Google Groups with automatic role assignment
Add or remove users from Google Groups with support for multiple roles. The tool uses your organization's Google Workspace OAuth credentials for simple, secure authentication.
Setup Requirements
This tool uses OAuth authentication (not service accounts), making setup significantly simpler than traditional Google Workspace tools. Your organization just needs to connect Google Workspace once in the Risotto dashboard.
Quick Reference
Authentication Method: OAuth (no service account required)
Required OAuth Scopes:
https://www.googleapis.com/auth/admin.directory.group
Supported Roles:
- MEMBER (standard group member)
- OWNER (full management permissions)
- MANAGER (elevated permissions)
Step-by-Step Setup
Step 1: Connect Google Workspace (If Not Already Connected)
If your organization hasn't already connected Google Workspace to Risotto:
Log into the Risotto Dashboard and navigate to Settings > Integrations > Google Workspace
Connect Google Workspace
Find the Google Workspace card and click Connect
Authorize Risotto
Follow the OAuth flow to authorize Risotto. Make sure to grant the requested permissions:
https://www.googleapis.com/auth/admin.directory.user.readonlyhttps://www.googleapis.com/auth/admin.directory.group
Step 2: Enable the Tool
In the Risotto Dashboard, select Tools in the sidebar
Open the Google group
In the Tool groups list, select Google
Enable the Tool
Find Manage Google Group Members and click Enable
Configure the Tool
Optionally, open the tool and click Edit. Change the Name or Description, or set Requires Approval.
Save the Tool
Click Save
The tool will automatically use your organization's Google Workspace OAuth credentials and be available for selection when creating or editing a Runbook.
Features
Idempotent Operations
The tool is designed to be idempotent, meaning you can safely run the same operation multiple times:
- Adding an existing user: Returns success without error
- Removing a non-existent user: Returns success without error
This makes the tool safe to use in automated workflows and runbooks.
Supported Roles
When adding users to groups, the agent can specify one of three roles:
Standard group member with basic access
Full group management permissions
Elevated permissions between member and owner
Automatic Token Refresh
Risotto automatically manages OAuth token refresh:
- When the access token expires, Risotto uses the refresh token to get a new access token
- This happens transparently in the background
- You don't need to manually reconnect unless the refresh token itself expires (typically after 200 days of inactivity)
Limitations
- The tool acts with the permissions of the Google Workspace admin who connected the Admin API. It can change any group that this admin can manage.
- The tool does not check whether a group is locked in Google Admin.
- The tool does not check who owns a group, so it does not limit changes to groups that the requestor owns or manages.
To limit which groups the tool can change, attach an approval policy to the tool, or use a script tool that checks the group before it changes it.
Troubleshooting
Common Issues
Permission Requirements
The Google Workspace user who authorizes Risotto must have one of these admin roles:
- Super Admin (recommended) - Full access to all Google Workspace features
- Groups Admin (minimum required) - Can manage groups and group membership
OAuth vs. Service Account Authentication
This tool uses OAuth instead of service account authentication, which provides several advantages:
| Feature | OAuth (This Tool) | Service Account |
|---|---|---|
| Setup Complexity | Simple one-click | Complex multi-step setup |
| User Experience | Authorize once in dashboard | Download JSON, configure domain-wide delegation |
| Token Management | Automatic refresh | Manual key rotation required |
| Security | User-scoped permissions | Broad service account permissions |
| Maintenance | Zero maintenance | Requires periodic key rotation |
Security & Privacy
- OAuth Tokens: Stored encrypted in the Risotto database
- Automatic Refresh: Tokens are automatically refreshed before expiration
- Scope Limitation: Risotto only requests the minimum required permissions
- Audit Logs: All group membership changes are logged in Google Workspace audit logs
Additional Resources
Something wrong or missing? Report an issue · View as Markdown