Google Workspace
Connect your agents to Google Workspace for Gmail, Drive (including shared drives), Calendar, Docs, Sheets, Slides, Meet, Chat, Tasks, and more.
105 tools across 14 Google services.
Gmail (3 tools)
| Tool | Description |
|---|---|
gmail_send | Send email via the agent's assigned email address |
gmail_list | List emails with query filtering |
gmail_read | Read full email content by message ID |
Agents can send, list, and read emails. The gmail_list tool supports Gmail query syntax (e.g., from:support@company.com is:unread).
Google Drive (11 tools)
Full CRUD operations with shared drives support.
| Tool | Description |
|---|---|
drive_list | List files in a folder or shared drive |
drive_get | Get detailed file/folder metadata |
drive_read | Read/download file content (Google formats auto-exported) |
drive_upload | Upload file to Drive or shared drive (up to 50 MB) |
drive_update | Overwrite file content |
drive_create_folder | Create a folder |
drive_share | Share file with users (reader, commenter, writer, organizer) |
drive_move | Move file between folders or shared drives |
drive_rename | Rename a file or folder |
drive_delete | Trash or permanently delete a file |
drive_list_shared_drives | List all accessible shared drives |
Shared Drives
When a team has a provisioned shared drive, it is automatically used as the default for file operations. Agents do not need to specify a drive ID -- they can just call drive_list or drive_upload and it targets the team drive.
Agents can also work with shared drives across your organization by listing available drives and specifying a driveId.
Google Workspace Native Formats
When reading Google Docs, Sheets, Slides, or Drawings, the content is automatically exported:
| Google Format | Default Export |
|---|---|
| Google Docs | Plain text |
| Google Sheets | CSV |
| Google Slides | Plain text |
| Google Drawings | PNG |
You can override the export format by specifying an exportMimeType (e.g., text/html or application/pdf).
10 MB max for reads/downloads, 50 MB max for uploads. Binary files are returned as base64.
Google Docs (2 tools)
| Tool | Description |
|---|---|
docs_create | Create a new Google Doc |
docs_read | Read document content |
Google Sheets (3 tools)
| Tool | Description |
|---|---|
sheets_create | Create a spreadsheet with multiple sheets |
sheets_update | Update cells using A1 notation |
sheets_read | Read cell ranges |
Google Slides (4 tools)
| Tool | Description |
|---|---|
slides_create | Create a new presentation |
slides_add_slide | Add a slide with a layout |
slides_add_text | Add text boxes to a slide |
slides_get | Get presentation structure and slide IDs |
Available layouts: BLANK, TITLE, TITLE_AND_BODY, and more.
Google Calendar (2 tools)
| Tool | Description |
|---|---|
calendar_list_events | List events with date filtering |
calendar_create_event | Create event with attendees and Google Meet |
Set addMeetLink: true when creating an event to automatically attach a Google Meet link.
Google Meet (1 tool)
| Tool | Description |
|---|---|
meet_create | Create an instant or scheduled video conference |
Google Chat (3 tools)
| Tool | Description |
|---|---|
chat_list_spaces | List accessible Chat spaces |
chat_send_message | Send message to a space |
chat_create_space | Create a new Chat space |
Google Tasks (3 tools)
| Tool | Description |
|---|---|
tasks_list | List tasks from a task list |
tasks_create | Create a task with due date |
tasks_complete | Mark a task as completed |
Google Vault / eDiscovery (2 tools)
| Tool | Description |
|---|---|
vault_list_matters | List eDiscovery matters |
vault_create_matter | Create a new matter |
Google Analytics (2 tools)
| Tool | Description |
|---|---|
analytics_list_properties | List GA4 properties |
analytics_run_report | Run custom analytics reports with dimensions and metrics |
Google Ads (2 tools)
| Tool | Description |
|---|---|
ads_list_campaigns | List ad campaigns (requires developer token) |
ads_get_metrics | Get campaign performance metrics |
YouTube (5 tools)
| Tool | Description |
|---|---|
youtube_list_videos | List channel videos |
youtube_get_analytics | Get channel analytics |
youtube_update_video | Update video metadata |
youtube_create_playlist | Create a new playlist |
youtube_add_to_playlist | Add videos to a playlist |
Google Admin (5 tools)
Enterprise administration tools for provisioning users, groups, and shared drives. Requires domain-wide delegation via service account.
| Tool | Description | Requires Approval |
|---|---|---|
google_admin_create_group | Create a Google Group | Yes |
google_admin_add_group_member | Add member to a group | No |
google_admin_create_shared_drive | Create a shared drive | Yes |
google_admin_add_drive_permission | Add permission to a shared drive | No |
google_admin_create_user | Create a user account | Yes |
Tools marked "Requires Approval" are gated because they incur costs (license fees) or create organization-wide resources. A human must approve before the agent can execute them.
Automatic Workspace Provisioning
When you start a team with Google Workspace connected, MeetLoyd can automatically create a Shared Drive for the team with standard folders (Reports, Working, Shared, Archive) and add agents as members.
- Service account configured: Workspace created automatically during team first-start
- No service account: A guided task is created for your admin to set up manually
Team bosses and lead agents get organizer access, regular agents get writer access.
After provisioning, workspace details (drive name, ID, URL, folders) are automatically injected into agent prompts so agents immediately know about their team workspace.
Agents without a personal email can still use all Drive, Docs, Sheets, and Slides tools through the service account directly (no per-agent Google Workspace license needed). Gmail, Calendar, and other user-specific tools still require a personal email.
See Team Workspace Provisioning for full details.
Files & Attachments Integration
Google Drive tools work alongside MeetLoyd's file management system:
- Agents can read files from Drive and reference them in conversations
- Agents can upload generated documents to Drive or shared drives
- Files downloaded from Drive can be parsed and chunked for RAG via the MeetLoyd file parser
- Chat file attachments are stored locally; Drive files stay in Google's infrastructure
Setup & Configuration
Authentication Options
There are two ways to connect Google Workspace:
| Method | Best For | How It Works |
|---|---|---|
| Service Account (recommended) | Production agent teams | Domain-wide delegation; agent impersonates its assigned email |
| OAuth (interactive) | Quick testing, individual use | User authorizes in browser; tokens stored per-connection |
Service Account Setup
- Create a service account in Google Cloud Console
- Enable the APIs you need (Gmail API, Drive API, Calendar API, etc.)
- In Google Admin Console, go to Security > API controls > Domain-wide delegation
- Add your service account client ID with the required scopes
- Store the service account credentials in MeetLoyd's vault
- Assign an email address to each agent that needs Gmail or Calendar access
Required OAuth Scopes
| Service | Scopes |
|---|---|
| Gmail | gmail.readonly, gmail.send, gmail.modify, gmail.compose |
| Drive | drive, drive.file |
| Docs/Sheets/Slides | documents, spreadsheets, presentations |
| Calendar | calendar, calendar.events |
| Chat | chat.spaces, chat.messages, chat.memberships |
| Tasks | tasks |
| Vault | ediscovery |
Admin Tools Setup
Admin tools require additional domain-wide delegation scopes:
| Scope | Purpose |
|---|---|
admin.directory.user | User provisioning |
admin.directory.group | Group management |
drive | Shared drive creation |
Enable the Admin SDK API in Google Cloud Console before configuring these scopes.
Best Practices
Use minimal scopes. Only request the scopes your agents actually need. If an agent only reads emails, use gmail.readonly instead of gmail.modify.
Use shared drives for team content. Shared drives provide consistent access for all agents in a team without per-user sharing.
Specify export formats explicitly. When reading Google Workspace files, specify the export format if the default does not suit your needs (e.g., text/html for formatted docs).
Troubleshooting
"Access Denied" -- Check that the user has a Google Workspace license, verify OAuth scopes include the required API, and check the Google Admin console for API restrictions.
"Rate Limit Exceeded" -- Google APIs have per-user and per-project limits:
| API | Limit |
|---|---|
| Gmail | 250 quota units/user/second |
| Drive | 12,000 requests/day |
| Calendar | 500 requests/100 seconds |
"Invalid Grant" -- The OAuth token has expired or been revoked. Re-authorize the connection from the Integrations page.
Next: Explore Microsoft 365 integration.