Skip to main content

At a glance

  • Availability: Enabled by default.
  • Auth: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider’s consent screen.
  • Scopes: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.send, https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/gmail.labels, https://www.googleapis.com/auth/gmail.compose, https://mail.google.com/.

Credentials

Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.
VariableRequiredDescription
GOOGLE_CLIENT_IDYesGoogle OAuth Client ID Docs.
GOOGLE_CLIENT_SECRETYesGoogle OAuth Client Secret Docs.

Tools

ToolAccessDescription
List EmailsReadList Gmail message summaries with IDs, sender, recipient, subject, date, snippet, labels, and pagination tokens. Use get-email only when full message content is needed.
Send EmailWriteSend an email to recipients
Get EmailReadGet a specific email by ID with full content
Search EmailsReadSearch Gmail messages and return summaries with IDs, sender, recipient, subject, date, snippet, labels, and pagination tokens.
Mark Email ReadWriteMark an email as read
Archive EmailWriteArchive an email
List LabelsReadList Gmail labels
Get LabelReadGet a Gmail label
Create LabelWriteCreate a Gmail user label
Update LabelWriteUpdate a Gmail user label
Delete LabelWriteDelete a Gmail user label
Apply LabelsWriteApply or remove labels on an email
Modify Email LabelsWriteModify labels on an email
Trash EmailWriteMove an email to trash
Untrash EmailWriteRemove an email from trash
Delete EmailWritePermanently delete an email
Batch Modify EmailsWriteModify labels on multiple emails
Batch Delete EmailsWritePermanently delete multiple emails
List ThreadsReadList Gmail threads
Get ThreadReadGet a Gmail thread
Modify Thread LabelsWriteModify labels on a Gmail thread
Trash ThreadWriteMove a Gmail thread to trash
Untrash ThreadWriteRemove a Gmail thread from trash
Delete ThreadWritePermanently delete a Gmail thread
Create DraftWriteCreate a Gmail draft
List DraftsReadList Gmail drafts
Get DraftReadGet a Gmail draft
Update DraftWriteReplace a Gmail draft
Send DraftWriteSend an existing Gmail draft
Delete DraftWritePermanently delete a Gmail draft
Get AttachmentReadGet a Gmail message attachment
Get ProfileReadGet the Gmail mailbox profile
List HistoryReadList Gmail mailbox history changes

Example prompts

  • Summarize my unread emails from today. Group them by priority and highlight any that need immediate attention.
  • Help me draft a reply to my most recent email. Keep it professional and concise.
  • Search my emails for important messages from the past week that I might have missed.