AIDA by Autafy
AIDA Documentation

Google Workspace Setup

Last updated October 23, 2026 · AIDA docs v11 · All documentation

What you get

Connecting Google Workspace gives AIDA access to:

  • Gmail — read, search, send, and manage emails
  • Google Calendar — view and create events
  • Google Drive — search and read files
  • Google Tasks — manage your task lists
  • Google Docs / Sheets / Slides — create and edit documents

Before You Start

You need:

Step 1 — Create a Google Cloud Project

  1. Go to console.cloud.google.com
  2. Click Select a project at the top
  3. Click New Project
  4. Name it AIDA (or anything you prefer)
  5. Click Create
  6. Make sure your new project is selected in the top dropdown

Step 2 — Enable Required APIs

  1. In the left menu, go to APIs & Services → Library
  2. Search for and enable each of these APIs:
    • Gmail API — click Enable
    • Google Calendar API — click Enable
    • Google Drive API — click Enable
    • Google Tasks API — click Enable
  1. Go to APIs & Services → OAuth consent screen
  2. Select External as the user type
  3. Click Create
  4. Fill in the required fields:
    • App name: AIDA
    • User support email: your email
    • Developer contact email: your email
  5. Click Save and Continue through the remaining steps
  6. Return to the OAuth consent screen (or the Audience tab) and set Publishing status to In production (click Publish App and confirm)
    • Required so your connection does not expire after 7 days, which happens while the app stays in Testing mode
    • Because the app is External, first sign-in shows an "unverified app" warning — click Advanced → Go to AIDA (unsafe) to proceed. This is expected and safe for self-hosted apps (your own app connecting to your own account)

Step 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. Name it AIDA
  5. Under Authorized redirect URIs, click Add URI and enter:
    ``
    https://YOUR-DOMAIN/api/google/callback
    `
    > Replace     YOUR-DOMAIN with the domain where your AIDA is installed (e.g. aida.yourbusiness.com`). It must be https with a real domain — a bare server IP will not work.
  6. Click Create
  7. A popup will show your Client ID and Client Secret — copy both
Important: Copy both values before closing the popup. You can always find them again in Credentials → your OAuth client.

Step 5 — Configure in AIDA

  1. Open AIDA → Settings
  2. Scroll to Google Workspace
  3. Enter your Client ID and Client Secret
  4. Click Save
  5. Click Connect Google
  6. A Google sign-in window will open
  7. Sign in with your Google account
  8. Click Allow to grant permissions
  9. The window will close and show Connected in green

Step 6 — Test the Connection

Ask AIDA in chat:

  • "Check my Gmail inbox"
  • "What's on my Google calendar today?"
  • "Show my Google Tasks"

Troubleshooting

"Access blocked" error Your app is in testing mode and your email is not added as a test user.

  1. Go to APIs & Services → OAuth consent screen
  2. Click Test users → Add Users
  3. Add your Google email address
  4. Try connecting again

"Token expired" error AIDA refreshes tokens automatically. If this persists, go to Settings → Google Workspace → Disconnect, then reconnect.

APIs not working Make sure all four APIs (Gmail, Calendar, Drive, Tasks) are enabled in your project under APIs & Services → Enabled APIs.

Security Notes

Run AIDA on your own server.7-day free trial, full product, no credit card. Install guide → · One-time license →