gmail

name	gmail
description	Search, read, send, and manage Gmail emails via Google API
requires	{"oauth":[{"provider":"google","scopes":["https://www.googleapis.com/auth/gmail.readonly","https://www.googleapis.com/auth/gmail.send","https://www.googleapis.com/auth/gmail.modify"]}]}

Gmail

Search, read, send, and manage Gmail emails using the Google Gmail API with OAuth authentication.

Setup

Connect your Google account via Settings > Integrations > Google > Connect. The OAuth flow requests Gmail read, send, and modify permissions. No app passwords or CLI tools needed.

Tools

gmail_search

Search Gmail messages using full Gmail search syntax (same as the Gmail search bar).

Parameters:

• query (required): Gmail search query (e.g. is:unread, from:[e-mail] newer_than:7d, subject:deploy)
• maxResults (optional): Maximum number of messages to return (default: 20, max: 100)

Returns: Message IDs, subjects, senders, dates, and snippets.

gmail_read

Read the full body of a Gmail message by its message ID.

Parameters:

• messageId (required): Gmail message ID from gmail_search results

Returns: Full email with from, to, subject, date, body, and labels.

gmail_send

Send a plain text email via Gmail.

Parameters:

• to (required): Recipient email address
• subject (required): Email subject line
• body (required): Email body (plain text)
• cc (optional): CC recipient email address
• bcc (optional): BCC recipient email address

gmail_modify

Modify labels on a Gmail message (mark read/unread, archive, star).

Parameters:

• messageId (required): Gmail message ID
• addLabels (optional): Label IDs to add (e.g. ['STARRED', 'UNREAD'])
• removeLabels (optional): Label IDs to remove (e.g. ['UNREAD', 'INBOX'])

Common Gmail Search Queries

• is:unread — All unread messages
• is:starred — Starred messages
• from:[e-mail] — From a specific sender
• subject:meeting — Subject contains "meeting"
• newer_than:7d — Last 7 days
• has:attachment — Messages with attachments
• in:inbox — Inbox only
• label:important — Important messages