Google Workspace Integration

Connect Gmail, Google Calendar, Google Meet, and Google Drive — all through one Google Cloud project.

Overview

Talos integrates with four Google Workspace services: Gmail for email, Google Calendar for scheduling, Google Meet for video meetings, and Google Drive for file management.

All four services are connected through a single Google Cloud project with OAuth 2.0 authentication, so you only need to set up credentials once.

What You Need

  • A Google Cloud account (free tier is sufficient)
  • OAuth 2.0 credentials (Client ID and Client Secret)
  • API access enabled for Gmail, Calendar, Meet, and Drive

Step 1 — Create Google Cloud Project

  1. Go to console.cloud.google.com and sign in with your Google account.
  2. Click the project dropdown at the top and select "New Project".
  3. Name your project "Talos" (or any name you prefer) and click Create.

Step 2 — Enable APIs

Enable these four APIs in your Google Cloud project:

  • Gmail API
  • Google Calendar API
  • Google Meet REST API
  • Google Drive API
  1. In the Google Cloud Console, go to APIs & Services > Library.
  2. Search for each API and click Enable: Gmail API, Google Calendar API, Google Meet REST API, Google Drive API.
  3. Verify all four appear as "Enabled" in APIs & Services > Enabled APIs.

Step 3 — Create OAuth Credentials

  1. Go to APIs & Services > Credentials.
  2. Click "Create Credentials" and select "OAuth 2.0 Client ID".
  3. Choose application type: "Desktop app".
  4. Click Create and download the JSON file with your Client ID and Client Secret.

Step 4 — Authorize Scopes

Talos requires the following OAuth scopes to access your Google services:

ScopePurpose
gmail.modifyRead and send emails, manage labels
calendarList, create, and update calendar events
meetings.space.createdCreate meeting spaces and list recordings
driveList, search, download files, and create folders

Step 5 — Get Access Token

  1. Use the Google OAuth Playground (developers.google.com/oauthplayground) or the built-in Talos OAuth flow.
  2. Select the four scopes listed above and authorize with your Google account.
  3. Copy the access token and refresh token for use in Talos.

Step 6 — Configure in Talos

  1. Go to Settings > Integrations > Google in the Talos dashboard.
  2. Paste your access token (and optionally the refresh token for automatic renewal).
  3. Click "Test Connection" for each service to verify Gmail, Calendar, Meet, and Drive are working.

What You Can Do

Once connected, Talos can interact with all four Google Workspace services:

Gmail

  • Read inbox messages and search by subject, sender, or date
  • Send emails with attachments
  • List and manage labels
  • Mark messages as read/unread

Calendar

  • List upcoming events with attendees and who has accepted
  • Create events with automatic Google Meet links
  • Check team availability for scheduling

Meet

  • Create instant meeting links to share with your team
  • List past meeting recordings

Drive

  • List and search files across your Drive
  • Download files directly through Talos
  • Create folders for organizing documents

Calendar Tips

  • See who is joining your next meeting — Talos shows attendee RSVP status alongside each event.
  • Create meetings with automatic Google Meet link — no need to open Calendar separately.
  • Check team availability before scheduling — Talos queries free/busy status for all attendees.

Security

  • Tokens are stored encrypted in your Talos organization settings. They are never exposed in the UI after initial setup.
  • Scopes are minimal — Talos only requests the permissions it needs. No admin or domain-wide access is required.
  • You can revoke access at any time from your Google Account settings (myaccount.google.com > Security > Third-party apps).

Troubleshooting

ProblemSolution
"Token expired" errorRe-authorize through the OAuth flow or provide a refresh token for automatic renewal.
"API not enabled" errorGo to Google Cloud Console > APIs & Services > Library and enable the missing API.
"Quota exceeded" errorGoogle APIs have daily quotas. Wait 24 hours or request a quota increase in the Cloud Console.
"Scope not authorized" errorRe-authorize and make sure all four scopes (gmail.modify, calendar, meetings.space.created, drive) are selected.

Useful Links