Step 1: Navigate to the Integrations Page
Log in to your ClawStaff dashboard and click Integrations in the left sidebar. You will find the Google Workspace integration card under the Google Workspace section. It shows all 13 supported Google services and an “Add” button.
If you have already connected other integrations, they appear with a green “Connected” badge. Google Workspace will show as available until you complete the setup process.
Step 2: Start a New Connection
Click the Add Google Workspace button on the integration card. A configuration panel opens, showing all available Google services: Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat, Forms, Tasks, Contacts, Classroom, Apps Script, and Groups.
Each service has a toggle to enable or disable it, and a dropdown to choose the access level: Read-only or Full access. Only enable the services your Claw actually needs. This follows the principle of least privilege and requests only the necessary OAuth scopes from Google.
Step 3: Select Services and Access Levels
For each service you want to connect, flip the toggle to enable it and select the appropriate access level:
- Choose Read-only for services where your Claw only needs to view data: monitoring emails, reading calendar events, querying spreadsheets, or analyzing form responses.
- Choose Full access for services where your Claw needs to take action: sending emails, creating events, writing to spreadsheets, or generating documents.
You can always come back and adjust these settings later. Starting with read-only access and upgrading to full access after testing is a safe approach. Each change triggers a new OAuth consent flow so you can review the updated scopes.
Step 4: Name Your Connection
Give this connection a descriptive name like “Engineering Team Google” or “Support Inbox Connection.” This helps identify it in the dashboard when you have multiple Google Workspace connections, for example, one for the support team’s Gmail and another for the engineering team’s Drive and Docs.
The name is only visible within the ClawStaff dashboard. It does not appear in Google or affect how the integration works.
Step 5: Authorize with Google
Click Continue to Google to start the OAuth flow. You will be redirected to Google’s consent screen in a new tab. Google will display the exact OAuth scopes being requested, corresponding to the services and access levels you selected in the previous steps.
Review each scope carefully. If something looks unexpected, go back to the configuration panel and adjust your selections. Once you are satisfied, select the Google account to authorize and click Allow.
After authorization, Google redirects you back to the ClawStaff dashboard. You should see a success notification confirming the connection. If the redirect fails, check that pop-up blockers are not interfering and try again. The OAuth flow is standard and works with all modern browsers.
Step 6: Assign to a Claw
Once the connection is established, assign it to one or more Claws from the Claw configuration page. Select the Google Workspace connection from the available integrations list. The Claw will receive the OAuth tokens at runtime inside its ClawCage container and can immediately begin interacting with the authorized Google services.
Test the connection by triggering a simple read operation: have the Claw read your latest email, check your calendar, or list files in a Drive folder. If the operation succeeds, the integration is fully operational. If it fails, verify that the Google account has access to the resources you are trying to reach and that the correct scopes were authorized during the OAuth flow.