Gmail MCP Server

What it does

Read, search, and send Gmail messages. Manage drafts, threads, and labels; reply, forward, archive, trash, report spam, and triage your inbox.

How to install the Gmail MCP Server

Install it with one Smithery CLI line and enter the settings below when asked.

Claude Desktop

npx -y @smithery/cli install gmail --client claude

Cursor

npx -y @smithery/cli install gmail --client cursor

Remote server address (Streamable HTTP)

https://gmail.run.tools

Keys and passwords go only to the provider and your own machine; ListeningMind never receives them.

31 tools

• Arcade_ListApps See the apps the current caller can act on and whether they are connected. Returns each app's id, name, connected state, and (when connected) the account it is connected as.
• Gmail_ArchiveEmail Archive exactly one email: remove inbox membership; email stays searchable.
• Gmail_ChangeEmailLabels Add or remove one user-created label on at most 50 messages per call. A message already in the requested state is a noop, but the tool is not idempotent in query mode: repeated cal…
• Gmail_ChangeThreadLabels Add and remove labels on every message in a thread using the Gmail API. Use this to change a whole conversation at once (for example, marking a thread read by removing "UNREAD") in…
• Gmail_CreateLabel Create a new label in the user's mailbox. Gmail treats label names as case-insensitive-unique; creating a name that already exists reports a conflict rather than a duplicate.
• Gmail_DeleteDraftEmail Delete a draft email using the Gmail API.
• Gmail_DeleteLabel Delete a user-created label, resolving it by the name the user says. A misspelled name gets a close-match suggestion; a system label is rejected.
• Gmail_ForwardEmail Send a copy of one message to new recipients as a new conversation. The forward quotes the original body, prefixes the subject with Fwd:, carries filename-bearing attachments, and…
• Gmail_GetEmail Read one message by ID without loading the rest of its thread. Returns parsed sender and recipient headers, the subject, text and HTML bodies, labels, dates, and attachment metadat…
• Gmail_GetThread Get the specified thread by ID.
• Gmail_ListDraftEmails Lists draft emails in the user's draft mailbox using the Gmail API.
• Gmail_ListEmailAttachmentMetadata List metadata for a message's real attachments without loading their contents.
• Gmail_ListEmails Read emails from a Gmail account. By default returns metadata-only rows (no body/htmlbody) so high-volume triage stays within the context budget.
• Gmail_ListEmailsByHeader Search for emails by header using the Gmail API. By default returns metadata-only rows (no body/htmlbody). Pass includebody=True when full message text is needed.
• Gmail_ListLabels List all the labels in the user's mailbox.
• Gmail_ListThreads List threads in the user's mailbox. By default, obvious automated threads are excluded from results using no-reply sender patterns and Gmail's non-primary category filters (promoti…
• Gmail_ReplyToEmail Send a reply to an email message, optionally with one or more file attachments.
• Gmail_ReportSpam Report exactly one email as spam: move to Spam and remove from the inbox.
• Gmail_SearchEmailsByQuery Search Gmail with a raw query and return one page in the requested detail mode. Results follow Gmail's default newest-first order.
• Gmail_SearchThreads Search for threads in the user's mailbox.
• Gmail_SendDraftEmail Send a draft email using the Gmail API.
• Gmail_SendEmail Send an email using the Gmail API, optionally with one or more file attachments.
• Gmail_SetThreadTrashStatus Set whether an entire conversation is in Trash, affecting every message at once. Setting the current status again succeeds without changing the conversation.
• Gmail_TrashEmail Move exactly one email to Trash (recoverable; may be auto-purged later).
• Gmail_TriageEmails Apply one triage transition to at most 50 selected messages per call. Per-message transitions converge — a message already in the requested state is a noop — but the tool is not id…
• Gmail_UnsubscribeFromEmail Request removal from authenticated marketing mail and optionally trash it.
• Gmail_UpdateDraftEmail Update an existing email draft using the Gmail API. Single-part text/plain and single-part text/html drafts both support full body replacement; the rebuild follows the existing dra…
• Gmail_UpdateLabel Rename a user-created label, resolving it by the name the user says. The label's color and visibility settings are preserved.
• Gmail_WhoAmI Get comprehensive user profile and Gmail account information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Gma…
• Gmail_WriteDraftEmail Compose a new email draft using the Gmail API, optionally with file attachments.
• Gmail_WriteDraftReplyEmail Compose a draft reply to an email message, optionally with one or more file attachments.

Why it was picked · #7 · score 77

• Popularity (41%)84
• Trust (29%)80
• Member reviewsNot used this week
• Search demand (18%)84
• Search and AI Overview presence (12%)30

Source: Smithery · 57,738 uses · monthly searches 1,400 · First picked 2026-10-20

Trust checks

• ✓ Verified at the source
• ✓ In the official MCP Registry
• – Own homepage
• ✓ Live endpoint
• ✓ Clear description

How we pick →

Made it? Add the badge to your README

[![ListeningMind pick](https://daas.listeningmind.ai/badge/mcps/x-mcp-gmail.svg)](https://daas.listeningmind.ai/en/catalog/mcps/x-mcp-gmail)

How to buy

Reviews ·

No reviews yet.

Questions people ask