Skip to main content
Gmail Logo
Gmail Toolset

Email management and communication

ReadyGoogle Workspace

​
Overview

The Gmail toolset enables AI agents to send, read, and manage emails in Gmail.

​
Key Capabilities

  • Send and reply to emails
  • Create draft emails
  • Search and read messages
  • Access email attachments
  • View user profile information

​
Available Tools

​
Setup

​
Step 1: Create Google Cloud Project

  1. Go to Google Cloud Console
  2. Click the project dropdown and select “New Project”
  3. Enter a project name
  4. Click “Create”
Create Google Cloud Project

​
Step 2: Enable Gmail API

  1. Navigate to APIs & Services > Library
  2. Search for “Gmail API”
  3. Click on it and click “Enable”
Enable Gmail API
  1. Navigate to APIs & Services > OAuth consent screen
  2. Choose External user type (or Internal for Workspace accounts)
  3. Fill in app information:
    • App name: e.g., “Novaplan AI Gmail Toolset”
    • User support email: Your email
    • Developer contact email: Your email
  4. Click “Save and Continue”

​
Step 4: Add Required Scopes

  1. On the Scopes page, click “Add or Remove Scopes”
  2. Search and add these Gmail API scopes:
Scopes requested by the accessible toolset implementation:
  • https://www.googleapis.com/auth/gmail.send - Send emails
  • https://www.googleapis.com/auth/gmail.readonly - Read emails
  • https://www.googleapis.com/auth/gmail.modify - Broader mailbox permission requested by the implementation; it also authorizes the documented draft action
The accessible toolset creates drafts with Gmail’s users.drafts.create endpoint. Google accepts gmail.modify for that call, but also accepts the narrower gmail.compose scope. The toolset does not list a label-management action, while Google classifies gmail.modify as a restricted scope. Confirm the deployed scope request and whether draft creation can use narrower access before approving this broader permission; changing the application’s scopes requires an implementation and consent-flow check.
  1. Click “Update” and “Save and Continue”

​
Step 5: Get Redirect URI from Novaplan AI

  1. In Novaplan AI, open Workspace Settings → Actions.
  2. Find Gmail and choose + Setup or Configure.
  3. Copy the Redirect URI shown in the dialog
Copy Redirect URI from Novaplan AI

​
Step 6: Create OAuth Client ID

  1. Navigate to APIs & Services > Credentials
  2. Click “Create Credentials” > “OAuth client ID”
  3. Select “Web application”
  4. Enter a name (e.g., “Novaplan AI Gmail”)
  5. Under “Authorized redirect URIs”, click “Add URI”
  6. Paste the Redirect URI from Novaplan AI
  7. Click “Create”
The redirect URI must match exactly. Any mismatch will cause authentication to fail.
  1. Copy the Client ID and Client Secret from the popup

​
Step 7: Configure in Novaplan AI

  1. Return to the Novaplan AI Gmail configuration dialog
  2. Enter your Client ID and Client Secret
  3. Click “Authenticate”
Enter Credentials in Novaplan AI

​
Step 8: Authorize Access

  1. A popup window will open to Google’s authorization page
  2. Sign in with your Google account
  3. Review the permissions and click “Allow”
Google Authorization Screen
  1. You’ll be redirected back to Novaplan AI
  2. The toolset will show “Authenticated” status

​
FAQ

Example: Use Gmail Connector to search past email conversations. Use Gmail Toolset to let agents draft, send, or reply to messages. The listed tools do not include a dedicated forwarding action.

​
Usage Tips

How do I send an email?
Ask your agent to “send an email to user@example.com” and provide the subject and message. How do I search for emails?
Ask to “search my emails for [keyword]” or use specific criteria like “find emails from john@example.com with subject report”.