Google Workspace Integration
Connect a dedicated Google account to VoyagerClaw so it can interact with Google Workspace services — Gmail, Calendar, Drive, Docs, Sheets, Slides, Tasks, People, Forms, Chat, Classroom, and Apps Script.
We recommend creating a dedicated Google account for VoyagerClaw. This keeps your personal data separate and gives you full control over what VoyagerClaw can access.
If you are using Google Workspace, we recommend creating the bot account inside the Google Workspace.
What You Get
Once setup is complete, your VoyagerClaw machine will have the following configured automatically:
- The
gogCLI pre-loaded with the VoyagerClaw Google account's credentials, giving the agent access to 12+ Google APIs - Real-time Gmail push notifications via Google Pub/Sub, so VoyagerClaw can react to incoming emails sent to the dedicated account without polling
- Access to the full range of Google Workspace services:
| Service | What VoyagerClaw can do |
|---|---|
| Gmail | Read, draft, and send emails |
| Google Calendar | View and manage events |
| Google Drive | Access and organize files |
| Google Docs | Read and edit documents |
| Google Sheets | Read and edit spreadsheets |
| Google Slides | Read and edit presentations |
| Google Tasks | View and manage tasks |
| People (Contacts) | Access contact information |
| Google Forms | Read and manage forms |
| Google Chat | Send and read messages |
| Google Classroom | Access classroom resources |
| Apps Script | Manage Apps Script projects |
Prerequisites
Before you begin, make sure you have:
- Docker installed and running on your machine
Setup
- Go to the Settings tab on your VoyagerClaw dashboard
- Find the Google Account section
- Copy the provided
docker runcommand — it includes a short-lived authentication token - Paste the command into a terminal on your local machine and run it
The container launches an interactive setup flow. Follow the on-screen prompts — you will need to switch to a web browser at several points during the process.
Using Google Services
Once setup is complete, VoyagerClaw can interact with Google Workspace services using the dedicated account. You can issue natural language prompts directly. For example:
- "Check your Gmail inbox for unread messages"
- "Create a new Google Doc summarizing our meeting notes"
- "Add a meeting to your calendar for tomorrow at 2pm"
- "List recent files in your Google Drive"
VoyagerClaw will automatically use the dedicated account's credentials to fulfill these requests.
Accessing your personal Google data
VoyagerClaw's credentials are tied to its dedicated Google account — not your personal one. To let VoyagerClaw work with your personal Google data, you need to share or delegate access from your personal account to the VoyagerClaw account:
| Service | How to share access |
|---|---|
| Google Calendar | Share your calendar with the VoyagerClaw account's email address (instructions) |
| Google Drive | Share specific files or folders with the VoyagerClaw account's email address |
| Gmail (Option 1: Delegation) | Set up Gmail delegation to grant VoyagerClaw read and write access to your inbox — it can read, draft, and send emails on your behalf |
| Gmail (Option 2: Forwarding) | Set up email forwarding so VoyagerClaw receives its own copy of all incoming emails — it can read them but cannot make any changes to your original inbox |
| Google Docs / Sheets / Slides | Share individual documents with the VoyagerClaw account's email address |
Once access is shared, reference the delegation in your prompts so VoyagerClaw knows where to look:
- "Check the shared calendar from alice@example.com for tomorrow's meetings"
- "Open the Q3 report shared with you from the team Drive"
- "Read the latest emails in the delegated inbox from alice@example.com"
- "Draft a reply in the delegated Gmail from alice@example.com to the last message from Bob"