Connect Gmail to AI agents

Connect Gmail to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

modify_message

Modify Message

Modify a message's labels, move it to trash, or restore it from trash. Supports both single and batch operations on multiple messages.

manage_settings

Manage Settings

View and manage Gmail settings including vacation responder (auto-reply), mail filters, forwarding addresses, and send-as aliases with signatures.

manage_draft

Manage Draft

Create, update, send, list, get, or delete email drafts. Drafts can be composed with recipients, subject, body, and then sent when ready.

manage_labels

Manage Labels

List, create, update, get, or delete Gmail labels. Labels organize messages and threads (e.g., INBOX, SENT, STARRED, or custom labels).

manage_thread

Manage Thread

Get, list, modify labels, trash, or restore email conversation threads. Retrieve full thread conversations with all messages.

search_messages

Search Messages

Search and list email messages using Gmail query syntax. Returns parsed messages with headers, body, and attachment metadata. Use the same search operators available in the Gmail search bar: `from:`, `to:`, `subject:`, `has:attachment`, `after:`, `before:`, `is:unread`, `label:`, etc.

get_message

Get Message

Retrieve a single email message by its ID. Returns the full message including parsed headers, body (text and HTML), and attachment metadata.

send_email

Send Email

Send an email message to one or more recipients. Supports plain text and HTML bodies, CC/BCC recipients, file attachments (base64-encoded), and replying within existing threads.

get_attachment

Get Attachment

Download an email attachment by its ID. Returns the attachment as a file attachment plus its size. Use the attachment IDs from the message's attachments list.

search_google_contacts

Search Google Contacts

Searches the authenticated user's Google Contacts from the People API by name, email address, phone number, or other fields.

list_google_contacts

List Google Contacts

Lists the authenticated user's Google Contacts from the People API with pagination support. Use the `pageToken` from a previous response to fetch the next page.

get_google_contact

Get Google Contact

Retrieves detailed Google Contacts information for a People API resource name. Use `people/me` to get the authenticated user profile.

delete_messages_permanently

Delete Messages Permanently

Immediately and permanently delete one or more Gmail messages. This bypasses Trash and cannot be undone.

delete_thread_permanently

Delete Thread Permanently

Immediately and permanently delete a Gmail thread and all messages in it. This bypasses Trash and cannot be undone.

More integrations teams use with Gmail

Slack

Slack: connect with bot OAuth or user OAuth. Send, update, delete, and schedule messages; list and cancel scheduled messages; open DMs and group DMs; manage conversations, members, files, reactions, pins, bookmarks, reminders, user groups, and user status; search messages and files with user scopes; and retrieve user, conversation, and workspace info.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Discord

Send, edit, and delete messages in channels. Manage servers (guilds), channels, roles, members, invites, webhooks, threads, scheduled events, auto moderation rules, audit logs, application commands, and custom guild emojis. Add or remove users, assign roles, kick or ban members, and receive supported message, guild, channel, member, and inbound webhook triggers.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs. Listen for webhooks on page, blog, comment, attachment, space, label, and user events.

Google Drive

Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Apply and read custom labels on files. Monitor file and folder changes via push notifications or webhook subscriptions. Store app-specific data in a hidden per-user folder.

How to use Gmail on Metorial

Automate Client Appointment Reminders via Acuity and Gmail

Service businesses with high appointment volumes see no-show rates climb when reminder workflows are manual or inconsistent. This workflow checks upcoming Acuity appointments, reviews each client record, and sends personalized reminder emails via Gmail with appointment details and any required preparation instructions.

E-commerce Order Anomaly Detection and Customer Notification

Scan recent Shopify orders for anomalies such as high-value orders with mismatched shipping addresses or unusual item quantities, then notify the operations team via Slack and send a confirmation email to the customer.

Onboard New HubSpot Contacts with a Calendly Scheduling Link

When new leads are created in HubSpot, sales teams often delay follow-up because scheduling a first meeting requires back-and-forth email. This workflow detects new HubSpot contacts, creates a personalized Calendly scheduling link, and sends a follow-up email through Gmail so prospects can book immediately.

Salesforce Lead-to-Deal Pipeline Automation

Convert qualified Salesforce leads into contacts and opportunities, validate their email addresses, enrich company data, and notify the assigned rep via email with a summary of the new deal.

Scheduled Meeting Booking Workflow for Sales Teams

When a prospect requests a demo, check the rep's Calendly availability, create a scheduling link for the appropriate event type, and log the meeting details back into HubSpot with a follow-up task.

Shopify Inventory Reorder Alerts and Supplier Email Drafting

Scan inventory levels across Shopify locations, identify products below reorder threshold, and draft reorder emails to suppliers with product details and requested quantities ready for review.

Shopify Product Launch Coordination

Coordinate a new product launch by creating the product in Shopify, setting up a discount code for launch day, notifying the team in Slack, and sending a launch announcement email to the customer list.

Technical notes for Gmail

Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Configure mail settings including forwarding rules, filters, vacation responders, signatures, aliases, and delegates. Import and insert messages for migration. Sync mailbox changes incrementally via history API. Subscribe to mailbox change notifications via push notifications.

Connect Gmail to production AI agents

See how Metorial gives Gmail access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Gmail to AI agents with Metorial.

  1. Can Metorial connect Gmail to AI agents?
    Yes. Metorial connects AI agents to Gmail through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.