Skip to main content

Gmail integration

The Gmail integration gives the AI assistant read access to your Gmail mailbox. This lets you search, read, and summarize emails. The integration cannot send emails, create drafts, or modify messages.

Requirements​

  • Your administrator has made Google Workspace and the Gmail integration available for your environment.
  • Your organization uses a custom Google app.
  • You are allowed to use integrations in your environment.
  • You have a Google account with access to the mailbox you want to use.
  • You choose an available AI model that can use tools. The integration is not limited to OpenAI.

Available functions​

FunctionDescription
google_account_profileRetrieves the profile of the connected Google account
gmail_search_emailsSearches emails using Gmail search syntax (maximum 25 per search)
gmail_read_emailReads one email in full
gmail_batch_read_emailsReads up to 25 emails at once
gmail_read_threadReads a complete email conversation

Usage examples​

Searching emails​

  • "Search for emails about last month's tender"
  • "Which unread emails do I have from today?"
  • "Search for emails from the Communications department with an attachment"

Reading emails​

  • "What does the latest email from the alderman say?"
  • "Summarize the email conversation about the press meeting"
  • "What agreements are in the latest email from the project team?"

Getting started with Gmail​

  1. Open your profile menu and go to Preferences.
  2. In Tools settings → Integrations, under Offered by your organization, turn on the switch for Gmail.
  3. Sign in with your Google account and grant permission for read access to Gmail.
  4. Start a chat and ask your question. Gmail is now available by default in your chats.

You can also click Gmail in the Tools block on the dashboard. If needed, you will then sign in to Google and a chat with this integration will start immediately.

Privacy and security​

The Gmail integration only requests read access:

  • ✅ Search and read emails
  • ❌ Send no emails
  • ❌ Create no drafts
  • ❌ Modify or delete no emails

Access tokens are encrypted and stored only server-side. If you turn off the last Google integration in Preferences, the connection to your Google account will be disconnected. You can also revoke access via Google Account Security.

Limitations​

  • For attachments, the AI only sees the file names; the contents of attachments are not read.
  • Long emails are shortened.
  • If your Google connection has expired, Preferences will show the Reconnect button.

Use cases​

  • Finding correspondence: Quickly locate specific emails
  • Summarizing: Have long email conversations summarized
  • Preparing: List agreements and questions from previous messages

Search tips​

You can also use Gmail search operators in your questions:

OperatorExampleDescription
from:from:jan@example.comEmails from a specific sender
subject:subject:meetingEmails with a word in the subject
has:attachmenthas:attachmentEmails with attachments
is:unreadis:unreadUnread emails
after:after:2026/01/01Emails after a date