Connect your Gmail account with ClickUp to search your email inbox using Personal Connected Search!
What you'll need
The data in your Gmail account will not be available to anyone else through ClickUp.
Set up the Gmail integration
Set up the Gmail integration to start using Connected Search!
Search Gmail using Connected Search
After enabling the integration, you can use Personal Connected Search to search your email inbox from ClickUp.
No one else can search for files from your personal connections.
The Gmail integration allows you to search emails from the most recent year. This is a rolling time period, meaning your searchable email history always covers the last 365 days from the current date, not just from when you first connected your account.
Open Gmail from ClickUp
Once the integration is set up, use the Open Gmail command in the AI Command Bar to quickly open Gmail in a new tab.
Use Gmail tools with Brain AI
After connecting your Gmail account, you can use various Gmail tools in Brain and Super Agents.
Brain can attach a file from ClickUp to a Gmail draft or email, including a file Brain creates for you. Brain asks you to confirm before it creates the draft or sends the email. Super Agents can add files to Gmail drafts, but can't send Gmail emails.
To download a Gmail attachment with Brain, ask Brain about an email attachment.
Download Gmail attachments with a Super Agent
A Super Agent with Gmail tools can download an email attachment, analyze it, attach it to a task, a task comment, or a Doc, or send it in a new email.
To set this up, add the Gmail tools in the Tools section of the Super Agent's profile. The Super Agent uses the account selected for Gmail there, whoever triggers it.
Before it adds an attachment to a task, comment, or Doc, it asks for confirmation. The person who triggered it must have edit access to the destination.
Anyone who can trigger the Super Agent can see attachment content in its reply.
Gmail Automation Triggers
Use Gmail Triggers inside your ClickUp Automations to save time.
Allow Super Agents to search your inbox
To allow a Super Agent to search your connected Gmail account's inbox, activate External Search for Gmail in its profile.
Disconnect the integration
If you no longer want to search your Gmail inbox from ClickUp, you can disconnect the integration from the App Center.
OAuth scopes
Below is a table of all OAuth scopes for the Gmail integration so you can make informed security and compliance decisions before enabling it in your Workspace.
| Scope | Description |
| gmail.readonly | Allows reading messages, threads, labels, and attachments for Connected Search and for the Gmail tools in Brain and Super Agents |
| userinfo.email | Confirms which Gmail address is linked to ClickUp |
| gmail.compose | Allows creating, updating, and sending drafts, including attachments |
| gmail.send | Allows sending email, including drafts Brain created |
| gmail.modify | Allows changing labels and archiving, starring, or marking emails read |