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
| Function | Description |
|---|---|
google_account_profile | Retrieves the profile of the connected Google account |
gmail_search_emails | Searches emails using Gmail search syntax (maximum 25 per search) |
gmail_read_email | Reads one email in full |
gmail_batch_read_emails | Reads up to 25 emails at once |
gmail_read_thread | Reads 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
- Open your profile menu and go to Preferences.
- In Tools settings → Integrations, under Offered by your organization, turn on the switch for Gmail.
- Sign in with your Google account and grant permission for read access to Gmail.
- 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:
| Operator | Example | Description |
|---|---|---|
from: | from:jan@example.com | Emails from a specific sender |
subject: | subject:meeting | Emails with a word in the subject |
has:attachment | has:attachment | Emails with attachments |
is:unread | is:unread | Unread emails |
after: | after:2026/01/01 | Emails after a date |
Related integrations
- Google Calendar - View calendar appointments
- Google Drive - Search and read files
- Outlook Mail - Microsoft alternative