Google Drive Integration

Connect Google Drive so Slateo agents can read Google Docs, Sheets, and Slides directly from your workspace. This guide walks through creating a GCP project, configuring OAuth, and connecting in Slateo.

Prerequisites

You will need:

• A Google Cloud Platform (GCP) account
• Admin access to your Slateo organization

Get started

1. Create a GCP project

1. Go to the Google Cloud Console.
2. Click Select a project in the top bar, then New Project.
3. Name the project (e.g., "Slateo Integration") and click Create.
4. Make sure the new project is selected.

2. Enable the Google Drive API

1. In the GCP Console, navigate to APIs & Services > Library.
2. Search for Google Drive API.
3. Click on it and press Enable.

3. Configure the OAuth consent screen

1. Go to APIs & Services > OAuth consent screen.
2. Choose Internal if your organization uses Google Workspace, or External for testing.
3. Fill in the required fields:
   • App name: e.g., "Slateo"
   • User support email: your email
   • Developer contact email: your email
4. On the Scopes page, add:
   • https://www.googleapis.com/auth/drive.readonly
   • https://www.googleapis.com/auth/userinfo.email
5. Complete the remaining steps and click Save.

4. Create OAuth credentials

1. Go to APIs & Services > Credentials.
2. Click Create Credentials > OAuth client ID.
3. Select Web application as the application type.
4. Under Authorized redirect URIs, add your Slateo callback URL:
   • For production: https://yourdomain.com/redirect/api/google-drive/auth/callback
   • For local development: http://localhost:4321/api/google-drive/oauth/callback
5. Click Create and copy the Client ID and Client Secret.

5. Configure environment variables

Add the following to your Slateo server environment:

GOOGLE_DRIVE_CLIENT_ID=your-client-id
GOOGLE_DRIVE_CLIENT_SECRET=your-client-secret

6. Connect in Slateo

1. Open the Slateo Admin panel.
2. Go to Settings > Integrations.
3. Find Google Drive and click Connect Google Drive.
4. You will be redirected to Google to authorize access.
5. After authorizing, you will be redirected back to Slateo with the integration active.

Using Google Drive content

Once connected, you can use Google Drive content in several ways:

In the context menu

• Click the @ button or type @ in the chat input to open the context menu.
• Select Google Drive to search for files by name.
• Paste a Google Drive URL directly to auto-resolve the file.

Agent tools

Slateo agents have access to two Google Drive tools:

• Read Google Drive Doc — reads a Google Docs document, Sheets spreadsheet, or Slides presentation and returns its content as text.
• Search Google Drive — searches your connected Google Drive for files matching a query.

Supported file types

Disconnecting

1. Go to Settings > Integrations in the Slateo Admin panel.
2. Click Disconnect on the Google Drive integration.
3. This removes the stored OAuth tokens. You can reconnect at any time.

Troubleshooting

"No refresh token received"

This can happen if you previously authorized the app. Go to Google Account Permissions, revoke access for the app, and reconnect.

Files not appearing in search

The integration uses drive.readonly scope, which provides access to all files the authorizing user can see. Verify the file is accessible to the Google account that authorized the integration.

OAuth redirect errors

Ensure your authorized redirect URI in GCP matches exactly. Check for trailing slashes or protocol mismatches.

FAQ

Related documentation

• Notion Integration
• GitHub Integration
• Slack Integration