Skip to main content

​
Overview

Integrate Gmail to manage emails, labels, filters, and attachments directly from CORE. Access 20+ tools for complete email management including sending, drafting, advanced search, batch operations, and automation without leaving your workspace.

​
Setup Guide

  • Authentication Type : OAuth 2.0 (Google)

​
How to Connect

  1. Navigate to CORE Dashboard → Integrations
  2. Click on the Gmail card
  3. Click Connect to authorize CORE
  4. You’ll be redirected to Google to authorize the application
  5. Grant the required permissions
  6. You’ll be redirected back to CORE once connected

​
Use Cases

​
Action Use Cases

When you ask CORE to perform Gmail tasks, it uses MCP tools to execute your requests:
Scenario: Create and send emails programmatically with attachments and formatting
"Send an email to client@example.com with subject 'Project Update'
and attach the Q4 report PDF from my desktop"
The agent will use send_email to send immediately with HTML formatting, multiple recipients (To, CC, BCC), attachments, and threading support. Use draft_email to create a draft for later modification.
Scenario: Find emails using powerful Gmail search syntax
"Search for all emails from client@example.com sent after January 1st
that have attachments and contain the word 'invoice'"
The agent will use search_emails with Gmail’s query syntax to find emails by sender, subject, date range, attachments, and complex criteria with automatic timezone conversion.
Scenario: Organize and automate email management
"Create a label called 'Important Clients', then set up a filter
to automatically apply this label to emails from client@example.com"
The agent will:
  1. Use create_label to create custom labels for categorization
  2. Use create_filter_from_template to automatically organize incoming mail
  3. Apply filters to individual or batch emails for organization
Scenario: Download and manage email attachments
"Find the latest email from finance@company.com with PDF attachments
and download all attachments to my Downloads folder"
The agent will first use read_email to get attachment IDs and metadata (filename, size, MIME type), then use download_attachment to save them to custom locations.
Scenario: Efficiently handle large numbers of emails
"Find all emails from last month labeled 'newsletter'
and delete them in batches"
The agent will use search_emails to find matching emails, then use batch_delete_emails to process thousands of emails in controlled batches with automatic error handling and rate limit management.
Scenario: Build automated workflows for email management
"Search for all unread emails from support@example.com,
apply the 'Support' label, and mark them as read"
The agent will combine search_emails with batch_modify_emails to search for emails matching criteria, apply labels automatically, and create filters for ongoing automation.

​
Proactive Use Cases

With webhooks enabled, CORE monitors Gmail 24/7 and acts automatically based on your instructions:
Trigger: Email received from specific domain or senderAutomated Action: Forward to WhatsApp and prioritize
"When I receive an email from @importantclient.com,
immediately forward the subject and preview to my WhatsApp,
mark it with 'VIP' label,
and save sender details to CORE memory"
Never miss important emails. CORE routes critical messages to your preferred channel and flags them for immediate attention.
Trigger: Email received with “invoice” in subject from accounting domainAutomated Action: Extract data and create tracking entry
"When an invoice email arrives from accounting@company.com,
extract the invoice number, amount, and due date,
save to CORE memory with label 'invoices',
and create a task in Todoist to process it"
Automate invoice tracking. CORE extracts structured data from emails and creates action items across your workflow.
Trigger: Email received at support email addressAutomated Action: Create Linear issue and auto-respond
"When an email arrives at support@company.com,
create a Linear issue with the email content,
assign it to the support team,
and send an auto-reply confirming we received their message"
Convert emails to tickets instantly. CORE creates tracking issues in Linear and sends confirmation replies automatically.
Trigger: Email received from newsletter sendersAutomated Action: Organize and summarize
"When a newsletter arrives (identified by 'unsubscribe' link),
apply the 'Newsletters' label,
extract key headlines,
save to CORE memory for weekly digest,
and mark as read"
Tame newsletter overload. CORE automatically categorizes, extracts insights, and organizes newsletters for later review.
Trigger: Email contains meeting invitation or calendar eventAutomated Action: Add to calendar and prep materials
"When an email contains a meeting invitation,
extract the date, time, and attendees,
add it to Google Calendar,
search CORE memory for past context with attendees,
and send me a prep summary 1 hour before the meeting"
Prepare for meetings automatically. CORE parses invitations, schedules events, and provides context from past interactions.
Trigger: Email received with PDF attachment from specific senderAutomated Action: Download, extract, and notify
"When I receive an email with a PDF from contracts@company.com,
download the attachment,
extract key terms and dates,
save to CORE memory with label 'contracts',
and notify legal team on Slack"
Process attachments intelligently. CORE downloads files, extracts information, and routes to the right team automatically.

​
Scopes

  • gmail.send - Send emails on behalf of the user
  • gmail.compose - Create and modify drafts
  • gmail.readonly - Read email messages and settings
  • gmail.modify - Manage labels and organize emails
  • gmail.labels - Create and manage labels
  • gmail.settings.basic - Manage filters and email settings
  • gmail.metadata - Access email headers and metadata

​
Available MCP Tools

The Gmail integration provides 20+ tools for comprehensive email management:
Tool NameDescription
send_emailSend a new email with support for attachments, HTML formatting, and threading
draft_emailCreate a draft email without sending it for later modification
read_emailRetrieve the full content of a specific email message with headers and body
read_email_threadRetrieve all messages in an email thread/conversation in chronological order
modify_emailModify email labels (move to folders, apply/remove tags)
delete_emailPermanently delete an email message

​
Triggers

Gmail triggers enable CORE’s Meta Agent to wake up and act proactively when events are detected via scheduled polling.
EventDescription
GMAIL_MESSAGE_RECEIVEDTriggered when a new email is received
GMAIL_MESSAGE_SENTTriggered when an email is sent from your account
GMAIL_MESSAGE_LABELEDTriggered when a label is added to an email
GMAIL_MESSAGE_UNLABELEDTriggered when a label is removed from an email
GMAIL_MESSAGE_STARREDTriggered when an email is starred
GMAIL_MESSAGE_TRASHEDTriggered when an email is moved to trash

​
Need Help?

Join our Discord community for support in #core-support