Gmail MCP Server

Add/remove labels on multiple Gmail messages in one call.

Create a Gmail draft. Supports reply drafts via thread_id + in_reply_to + references and optional file attachments.

Create a Gmail inbox filter that auto-labels, archives, or forwards matching mail. criteria selects messages (from, to, subject, query, hasAttachment,...

Create a new Gmail label.

Delete an existing Gmail draft by draft ID. This permanently removes the unsent draft.

Delete a Gmail filter by ID.

Delete a Gmail label by ID.

Fetch detailed information about a specific Gmail label using its label ID. Use this when you need in-depth details about a label, like its type and m...

Fetch a Gmail message by ID. Use format=metadata when you only need headers; use format=full to include payload.

Fetch a Gmail thread by ID and return the raw Gmail API thread object (full MIME payload tree). Use when you need unprocessed structure, nested parts,...

Fetch a Gmail attachment, store it in S3, and return a short-lived download URL.

Get a Gmail draft by draft ID, including headers and readable body content.

Fetch a Gmail message and return normalized content (headers + plain-text body). Skips attachments. When html_body_available is true, pass include_htm...

Fetch up to 25 Gmail messages and return normalized content (headers, snippet, optional plain-text body). Skips attachments. For inbox triage, pass in...

Fetch a Gmail thread and return normalized content for all messages (headers + plain-text bodies). Skips attachments.

Fetch multiple Gmail threads and return normalized content for each. Skips attachments. Pass include_html=true when you need raw HTML (see html_body_a...

List saved email drafts in Gmail. Supports pagination and optional inclusion of spam/trash.

List Gmail filters (settings).

List Gmail history changes starting from a history ID. Returns history records with message IDs suitable for message detail or normalized content read...

Retrieve all labels present in your Gmail account. Use this to manage or organize your emails based on categories or custom tags. It returns a list of...

List attachments for a Gmail message (attachment_id, filename, mimeType, size).

List Gmail messages. Supports pagination, native Gmail search (q), label filtering, and optional inclusion of spam/trash.

Retrieve your Gmail profile information such as email address, messages total, and threads total. Use this when you need a summary of your account's b...

List Gmail threads. Supports pagination, native Gmail search (q), label filtering, and optional inclusion of spam/trash.

Add/remove labels on a Gmail message. To archive: remove INBOX. To mark unread: add UNREAD.

Send an existing Gmail draft by draft ID. Delivers the draft as a sent message and removes it from Drafts.

Send an email using Gmail. Supports replies via thread_id + in_reply_to + references and optional file attachments.

Update an existing Gmail draft by replacing its subject, body, recipients, optional threading headers, and attachments.

Update an existing Gmail label.

Validate the Gmail OAuth token and confirm required scopes are granted.