Skip to main content

Overview

The Google Gmail server enables AI assistants to interact with Gmail, providing comprehensive email management including message search, sending, labeling, and thread management through the Gmail API.

How to Add Google Gmail

1

Add Server

Add the Google Gmail server to your Nexus environment through the server directory.
2

Authorize

Simply log in with your Google account and approve the OAuth consent request. No admin approval needed.
3

Test Connection

Try “Show me my latest 5 emails” to verify the connection works.
Simple OAuth Consent: Gmail uses standard Google OAuth consent. No special admin approval or Google Workspace setup is required - works with any Gmail account.

What You Can Do

Email Search & Reading

Search messages with Gmail operators and read full content

Sending & Drafting

Send emails and create drafts directly from AI assistants

Thread Management

Read complete conversation threads and analyze email chains

Label Management

Create, update, and apply labels to organize your inbox

Available Tools (11)

Message Operations

Search messages using Gmail query operators. Returns Message IDs, Thread IDs, and web interface links for verification.
Retrieve full content of a specific message including subject, sender, and body.
Retrieve multiple messages in a single batch request (up to 5 messages). Supports full content or metadata-only format.
Send an email using your Gmail account with recipient, subject, and plain text body.
Create a draft email with optional recipient. Can be completed and sent later.

Thread Operations

Retrieve complete conversation thread including all messages in chronological order.
Retrieve multiple threads in batch (up to 25 threads). Useful for analyzing conversations at scale.

Label Management

List all labels in your Gmail account with IDs, names, and types.
Create, update, or delete labels. Control label visibility in both label list and message list.
Add or remove labels from a single message. Use to archive (remove INBOX) or delete (add TRASH).
Add or remove labels from multiple messages simultaneously for bulk organization.

Use Cases

“Find all emails from john@example.com in the last week” - Use Gmail search operators to locate specific messages.

Reading Messages

“Show me the content of the most recent email from the newsletter” - Retrieve and display full message content.

Batch Processing

“Get the last 5 messages from my inbox and summarize them” - Process multiple emails efficiently in one request.

Sending Email

“Send an email to sarah@example.com about tomorrow’s meeting” - Compose and send emails directly.

Draft Creation

“Create a draft email for the quarterly report” - Prepare emails for review before sending.

Thread Analysis

“Show me the entire conversation thread about the project proposal” - Read complete email chains.

Label Organization

“Create a label called ‘Important Projects’ and apply it to all emails from client@example.com” - Organize inbox with custom labels.

Bulk Label Operations

“Archive all emails from notifications@example.com” - Remove INBOX label from multiple messages.
Gmail Search Operators: Supports standard Gmail search syntax including from:, to:, subject:, after:, before:, has:attachment, is:unread, and more.Batch Limits: Message batch operations support up to 5 messages, thread batch operations support up to 25 threads.Label Operations: Archiving removes the INBOX label. Deleting adds the TRASH label. System labels like INBOX, SENT, TRASH cannot be deleted.