Gmail MCP Server
for AI Agents

Create and save a new unsent email draft in Gmail using RFC 2822 formatted message content encoded as base64url, without sending it to recipients.

Immediately send a previously saved draft email to all its recipients, removing it from the Drafts folder and placing the sent message in the Sent folder.

Retrieve a paginated list of all draft emails saved in the authenticated user's Gmail account, returning draft IDs and basic message metadata for subsequent retrieval.

Retrieve the full content of a specific draft email by its draft ID, with configurable response format to control the verbosity and structure of the data returned.

Fully replace the content of an existing draft by providing a new RFC 2822 message payload, enabling changes to recipients, subject, body, attachments, or any other email fields.

Permanently and irrecoverably delete a draft email by its draft ID, removing it from the Drafts folder immediately with no trash step or recovery option.

Create a new Gmail filter rule that automatically processes future incoming messages matching specified criteria, applying labels, archiving, forwarding, or removing other labels.

Retrieve all email filter rules configured in the Gmail account that automatically process incoming messages based on criteria like sender, subject, size, or custom search queries.

Retrieve the complete configuration of a specific Gmail filter rule by its ID, including the full matching criteria definition and the action applied to messages that match.

Permanently remove a Gmail filter rule by its ID, immediately stopping all future automatic processing of incoming messages that previously matched the filter's criteria.

Create a new custom Gmail label for organizing email messages, with options to set its display name, sidebar visibility, message list visibility, and a color theme.

Retrieve the complete list of Gmail labels in the authenticated user's mailbox, including both built-in system labels and user-created custom labels with their IDs required for filtering and modifying messages.

Retrieve the complete metadata for a specific Gmail label by its ID, including message and thread counts, sidebar visibility settings, and color configuration if set.

Partially update an existing Gmail label's name, visibility settings, or color using a PATCH request that only modifies the fields explicitly provided, leaving all other properties unchanged.

Permanently remove a custom Gmail label by its ID - all messages that had this label are preserved with the label stripped from them, and the label itself cannot be recovered.

Immediately send a new email message via Gmail by providing the complete RFC 2822 formatted message content encoded as a base64url string, delivering it directly to recipients without a draft step.

Retrieve a paginated list of email messages from the authenticated user's Gmail mailbox, returning message IDs and thread IDs that can be passed to get_message for full content retrieval.

Retrieve the complete content and metadata of a specific Gmail message by its ID, including all headers, body parts, and attachment references with MIME structure.

Permanently and irreversibly delete a Gmail message by its ID, bypassing the Trash folder entirely - use trash_message instead if there is any chance recovery may be needed.

Retrieve the current IMAP protocol settings for the Gmail account, including whether IMAP access is enabled for third-party email clients and how message deletion is handled by those clients.

Update the Gmail IMAP protocol settings to enable or disable IMAP access for third-party email clients, and configure how those clients handle message deletion and folder size limits.

Retrieve the current POP3 protocol settings for the Gmail account, showing which messages are accessible via POP3 and what happens to them in Gmail after a POP3 client downloads them.

Update the Gmail POP3 protocol settings to control which messages are downloadable by POP3 clients and what disposition action is applied to those messages in Gmail after a POP3 client retrieves them.

Retrieve the current vacation responder (out-of-office auto-reply) configuration, including whether it is active, the message content, the scheduled activation window, and recipient restriction policies.

Enable, disable, or update the Gmail vacation responder (out-of-office auto-reply) with custom message content, an optional scheduled activation window, and restrictions to limit which senders receive the auto-reply.

Search and list email conversation threads from Gmail using full Gmail search syntax, with support for filtering by sender, label, date, attachment presence, and other criteria.

Retrieve the complete email conversation thread including all messages in chronological order, with full MIME content, headers, body parts, and attachment references for each message.

Permanently and irreversibly delete an entire email thread and all its messages by thread ID, bypassing Trash - use trash_thread if there is any chance recovery might be needed.