Google Workspace Integration
Connect a dedicated Google account to KiloClaw so it can interact with Google Workspace services — Gmail, Calendar, Drive, Docs, Sheets, Slides, Tasks, People, Forms, Chat, Classroom, and Apps Script.
We strongly recommend creating a dedicated Google account specifically for KiloClaw rather than connecting your personal Google account. This keeps your personal data separate and gives you full control over what KiloClaw can access. Throughout this guide, "the KiloClaw Google account" refers to this dedicated account.
What You Get
Once setup is complete, your KiloClaw machine will have the following configured automatically:
- The
gogCLI pre-loaded with the KiloClaw Google account's credentials, giving the agent access to 12+ Google APIs - Real-time Gmail push notifications via Google Pub/Sub, so KiloClaw can react to incoming emails sent to the dedicated account without polling
- Access to the full range of Google Workspace services:
| Service | What KiloClaw 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 KiloClaw 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, KiloClaw 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"
KiloClaw will automatically use the dedicated account's credentials to fulfill these requests.
Accessing your personal Google data
KiloClaw's credentials are tied to its dedicated Google account — not your personal one. To let KiloClaw work with your personal Google data, you need to share or delegate access from your personal account to the KiloClaw account:
| Service | How to share access |
|---|---|
| Google Calendar | Share your calendar with the KiloClaw account's email address (instructions) |
| Google Drive | Share specific files or folders with the KiloClaw account's email address |
| Gmail (Option 1: Delegation) | Set up Gmail delegation to grant KiloClaw 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 KiloClaw 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 KiloClaw account's email address |
Once access is shared, reference the delegation in your prompts so KiloClaw 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"