# Gmail MCP Server > Read, search, and send Gmail messages. Manage drafts, threads, and labels; reply, forward, archive, trash, report spam, and triage your inbox. - Price: Free to connect · provider's own fees apply - URL: https://daas.listeningmind.ai/en/catalog/mcps/x-mcp-gmail - Source: Smithery https://smithery.ai/server/gmail - Rank this week: #7 (score 77) ## Install ``` npx -y @smithery/cli install gmail --client claude ``` - Remote: https://gmail.run.tools ## Tools (31) - `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. ## FAQ ### What is the Gmail MCP Server? Read, search, and send Gmail messages. Manage drafts, threads, and labels; reply, forward, archive, trash, report spam, and triage your inbox. It is listed on Smithery and ranks #7 (score 77) in ListeningMind.AI's weekly picks. ### How do I install the Gmail MCP Server? Run npx -y @smithery/cli install gmail --client claude in a terminal to add it to Claude Desktop. For Cursor, use --client cursor. ### Do I need an API key? The provider lists no required settings. ### Which tools does it provide? 31 tools: Arcade_ListApps, Gmail_ArchiveEmail, Gmail_ChangeEmailLabels, Gmail_ChangeThreadLabels, Gmail_CreateLabel, Gmail_DeleteDraftEmail, Gmail_DeleteLabel, Gmail_ForwardEmail, Gmail_GetEmail, Gmail_GetThread, Gmail_ListDraftEmails, Gmail_ListEmailAttachmentMetadata. ### How much does it cost? Free to connect · provider's own fees apply. The provider may charge for use on its own terms. ### Can I trust it? Checks passed: Verified at the source, In the official MCP Registry, Live endpoint, Clear description. Skim a server or repository you have not used before connecting it.