Gmail MCP server
gmail.com, developers.google.com
Yes. Gmail publishes an official MCP server at https://gmailmcp.googleapis.com/mcp/v1. It's hosted and needs an OAuth app that you set up in Gmail first. It offers 23 tools. We last checked it on 22 Nov 2026.
Official: documented on Gmail's own site, at developers.google.com. Checked 22 Nov 2026. Maintained by Stuart Brameld.
Key facts
As of 22 Nov 2026, Gmail's official MCP server scores 79/100 on MartechDB's Agent Readiness Index (v1.1), 7th of 11 in Workplace communication. It answered 53 of our 53 checks in the last 90 days and lists 23 tools.
How the Agent Readiness Index works · Wrong? Suggest a correction
Gmail MCP server review
79/100
Gmail's MCP server scores 79/100 on MartechDB's Agent Readiness Index: easy to connect an AI agent to, with a few gaps. That ranks it 7th of 11 in Workplace communication.
The good
Hosted by Gmail: connect by URL, with nothing to install
Documented, with 23 tools known
Answered 100% of our checks in the last 90 days
Free plan or free quota
The bad
Signing in needs an app registered with Gmail first
Access goes through sales
Official MCP server
Gmail MCP server
Lets your AI assistant read and draft Gmail messages. In developer preview, using your own Google Cloud project.
- Address
- https://gmailmcp.googleapis.com/mcp/v1
- Runs
- Hosted
- Sign-in
- Cost to use
- Plan: Google Workspace Developer Preview Program · Free to start · Through sales1,200,000 quota units/minute per project, 6,000 per user; charges planned above 80,000,000 units/dayFrom Gmail's own page, limits from this page
- Official MCP Registry
- Not listed
- How we know it's official
-
- Documented on Gmail's own site, at developers.google.com.
- Tools
- 23 tools · listed 22 Nov 2026
- First seen
- 1 Oct 2026
- Last checked
-
Reachable ·
16 Nov 2026: reachable17 Nov 2026: reachable18 Nov 2026: reachable19 Nov 2026: reachable20 Nov 2026: reachable21 Nov 2026: reachable22 Nov 2026: reachable
- Uptime
- 100% · 53 of 53 checks reachable since 1 Oct 2026
Gmail MCP server tools (23)
As the server lists them. Names and descriptions are the vendor's own.
-
create_draftCreate draft emailCreates a new draft email in the authenticated user's Gmail account. This tool takes recipient addresses (`to`, `cc`, `bcc`), a `subject`, and body content as inputs. Plain text body content can be provided in `body` (do NOT format `body` with Markdown), and rich-text HTML content can be provided in `htmlBody` (use valid HTML tags for formatting; if both are provided, `body` serves as the plain-text alternative). If the draft is created as a reply to an existing message, the ID of the original message should be passed to the tool in the `replyToMessageId` field. Set `includeSignature` to true to append the user's configured Gmail web signature to the draft. Returns a Draft object with the `id`, `threadId`, and `viewUrl` fields populated.
-
list_draftsList draft emailsLists draft emails from the authenticated user's Gmail account, optionally filtered by a query string. Note: An empty JSON object `{}` represents zero matching items, not an error.
-
get_draftGet draft emailRetrieves a specific draft email from the authenticated user's Gmail account by ID, including its `viewUrl` for viewing and editing in the Gmail Web UI. The optional `messageFormat` parameter controls the format of the draft returned. By default (or with `PLAIN_TEXT`), it returns the plain text body without the HTML body. Use `MINIMAL` to return snippet and key headers, `METADATA_ONLY` to exclude snippet, subject, and body, `FULL_CONTENT` for the complete draft including the HTML body, or `RAW` for the raw MIME message content.
-
get_threadGet email threadRetrieves a specific email thread from the authenticated user's Gmail account, including its `viewUrl` and a list of its messages (each with their own `viewUrl`). Note: This tool does not support retrieving drafts. Any draft messages within a thread are omitted. To view drafts, use the `list_drafts` tool instead. The optional `messageFormat` parameter controls the format of the messages returned. By default (or with `PLAIN_TEXT`), it returns the plain text body without the HTML body. Use `FULL_CONTENT` only when the HTML body is needed. Use `MINIMAL` to include only subject and snippet (excluding body). Use `METADATA_ONLY` to include only basic metadata (message ID, thread ID, viewUrl, labels, timestamp, and size estimate).
-
get_messageGet email messageRetrieves a specific email message from the authenticated user's Gmail account by its unique message ID, including its `viewUrl`. Use this tool to inspect a single, individual email when you already know its message ID. If the user wants to read a specific email in detail, check the exact wording of a message, or examine attachment metadata for a single email, this is the right tool. It is not suitable for retrieving entire conversations or viewing back-and-forth discussion threads; use the 'get_thread' tool instead. Note: This tool does not support retrieving draft messages. To view drafts, use the 'list_drafts' tool instead. Key indicators include if the user asks for the full content of a specific message ID returned by a previous search, or if the query asks to inspect a specific individual email rather than an entire thread. Example user prompts are: "Get the full text of message ID 18f123456789abcd.", "Read the latest message in that thread from Alice.", and "What are the attach…
-
search_threadsSearch email threadsLists email threads from the authenticated user's Gmail account. This tool can filter threads based on a query string and supports pagination. It returns a list of threads, each with its thread `id`, `messageCount` (total messages in the thread), `viewUrl`, and a subset of up to 5 related messages (each with its own message `id`, `viewUrl`, `sender`, recipients, `date`, and `labelIds`). Use this tool to find thread `id`s matching a query before reading full threads or performing actions on matching emails or threads. The `view` parameter controls which additional fields are populated in the returned message subset. By default (or with `THREAD_VIEW_MINIMAL`), it includes `subject` and `snippet`. Use `THREAD_VIEW_METADATA_ONLY` to exclude `subject` and `snippet`, `THREAD_VIEW_SUMMARY` to return `THREAD_VIEW_MINIMAL` fields with only the most recent message per thread, or `THREAD_VIEW_IDS_ONLY` to return only `id` on each thread without fetching per-thread message metadata. Full message…
-
label_threadAdd labels to threadAdds labels to an entire thread in the authenticated user's Gmail account. This operation affects all messages currently in the thread and any future messages added to it. If unsure of a user label's ID, use the `list_labels` tool first to discover available labels and their IDs. To move a thread to a different inbox category tab, add the target `CATEGORY_*` label (e.g. `CATEGORY_PERSONAL` for Primary); Gmail automatically removes the previous category. To move a thread to Trash or mark it as Spam, please use the `trash_thread` or `mark_thread_spam` tool instead.
-
unlabel_threadRemove labels from threadRemoves labels from an entire thread in the authenticated user's Gmail account. This operation affects all messages currently in the thread. Use `unlabel_thread` when removing labels from an email or thread (such as marking it as read by removing `UNREAD`, archiving it by removing `INBOX`, or removing user-defined labels), even if the thread currently contains only 1 message. If unsure of a user label's ID, use the `list_labels` tool first.
-
apply_sensitive_thread_labelApply sensitive label (Trash or Spam) to threadPrefer `trash_thread` or `mark_thread_spam` instead. Adds a sensitive label (Trash or Spam) to a single thread in the authenticated user's Gmail account. This operation affects all messages currently in the thread. Use `apply_sensitive_thread_label` when applying Trash or Spam to exactly 1 thread.
-
trash_threadMove thread to TrashMoves an entire thread to the Trash (soft delete) in the authenticated user's Gmail account. This operation affects all messages currently in the thread. This is the default tool (along with `trash_message`) when a user asks to 'delete', 'remove', or 'get rid of' an email or thread without explicitly requesting permanent, irreversible deletion. Use `trash_thread` when trashing a thread, even if it currently contains only 1 message. Trashing at the thread level ensures all current messages in the thread are moved to Trash.
-
untrash_threadRemove thread from TrashRemoves an entire thread from the Trash in the authenticated user's Gmail account. This does not return the thread to the Inbox; to move it to the Inbox, add the `INBOX` label separately.
-
mark_thread_spamMark thread as SpamMarks an entire thread as Spam in the authenticated user's Gmail account. This operation affects all messages currently in the thread. Use `mark_thread_spam` when marking a thread as spam, even if it currently contains only 1 message. Marking spam at the thread level ensures all current messages in the thread are marked as Spam.
-
unmark_thread_spamUnmark thread as SpamUnmarks an entire thread as Spam in the authenticated user's Gmail account. This does not return the thread to the Inbox; to move it to the Inbox, add the `INBOX` label separately.
-
list_labelsList labelsLists all labels available in the authenticated user's Gmail account. Use this tool to discover the `labelId` and display `name` of each label in `labels` before calling `label_thread`, `unlabel_thread`, `label_message`, or `unlabel_message`. Note: the system labels, `DRAFT` and `SENT`, cannot be set on messages and are read only. Inbox category tabs are represented by system labels: `CATEGORY_PERSONAL` (Primary), `CATEGORY_SOCIAL` (Social), `CATEGORY_PROMOTIONS` (Promotions), `CATEGORY_UPDATES` (Updates), and `CATEGORY_FORUMS` (Forums). A message has at most one category: adding a category label moves the message to that tab and automatically removes its previous category, and removing a category label without adding another moves the message to Primary. Note: An empty JSON object `{}` represents zero matching items, not an error.
-
label_messageAdd labels to messageAdds one or more labels to a specific message in the authenticated user's Gmail account. To find the message ID, use the `get_thread` tool. If unsure of a user label's ID, use the `list_labels` tool first to discover available labels and their IDs. To move a message to a different inbox category tab, add the target `CATEGORY_*` label (e.g. `CATEGORY_PERSONAL` for Primary); Gmail automatically removes the previous category. To move a specific message to Trash or mark it as Spam, please use the `trash_message` or `mark_message_spam` tool instead.
-
update_message_labelsModify message labelsAtomically adds and/or removes labels from a specific message in the authenticated user's Gmail account. Requires at least one of `addLabelIds` or `removeLabelIds` to be provided. Moving an email between labels can be accomplished in a single call by specifying the target label in `addLabelIds` and the current label in `removeLabelIds`. For inbox category tabs, adding the target `CATEGORY_*` label (e.g. `CATEGORY_PERSONAL` for Primary) is sufficient; Gmail automatically removes the previous category.
-
unlabel_messageRemove labels from messageRemoves one or more labels from a specific message in the authenticated user's Gmail account. To find the message ID, use the `get_thread` tool. If unsure of a user label's ID, use the `list_labels` tool first to discover available labels and their IDs.
-
apply_sensitive_message_labelApply sensitive label (Trash or Spam) to messagePrefer `trash_message` or `mark_message_spam` instead. Adds a sensitive label (Trash or Spam) to a single message in the authenticated user's Gmail account. Use `apply_sensitive_message_label` when applying Trash or Spam to exactly 1 message. If the message belongs to a thread that should be labeled as a whole, prefer `trash_thread` or `mark_thread_spam`. To find the message ID, use the `get_thread` tool. To find the draft message ID, use tools like `list_drafts`.
-
trash_messageMove message to TrashMoves a specific message to the Trash (soft delete) in the authenticated user's Gmail account. This is the default tool (along with `trash_thread`) when a user asks to 'delete', 'remove', or 'get rid of' a message without explicitly requesting permanent, irreversible deletion. Use `trash_message` when targeting a specific message within a thread. To trash an entire thread or a single-message thread, prefer `trash_thread`. To find the message ID, use the `get_thread` tool. To find the draft message ID, use tools like `list_drafts`.
-
untrash_messageRemove message from TrashRemoves a specific message from the Trash in the authenticated user's Gmail account. This does not return the message to the Inbox; to move it to the Inbox, add the `INBOX` label separately. To find the message ID, use the `get_thread` tool.
-
mark_message_spamMark message as SpamMarks a specific message as Spam in the authenticated user's Gmail account. To find the message ID, use the `get_thread` tool.
-
unmark_message_spamUnmark message as SpamUnmarks a specific message as Spam in the authenticated user's Gmail account. This does not return the message to the Inbox; to move it to the Inbox, add the `INBOX` label separately. To find the message ID, use the `get_thread` tool.
-
create_labelCreate labelCreates a new label in the authenticated user's Gmail account. Supports creating nested labels (sub-labels) using a forward slash (e.g., 'Projects/Alpha/Sprint-1'). By default, parent labels will be automatically created if they do not exist.
Connect your AI to Gmail
Add the official Gmail MCP server to Claude, ChatGPT or your editor.
Connect Gmail MCP to Claude
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it Gmail, paste the address below and click Add.
Connect Gmail MCP to ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it Gmail and paste the address below.
ChatGPT usually only connects to servers with self-serve sign-in or none.
Connect Gmail MCP to Cursor
Opens Cursor if it's installed. If nothing happens, use the JSON below.
Connect Gmail MCP to VS Code
Opens VS Code if it's installed. Otherwise add the JSON settings from the Cursor tab to your .vscode/mcp.json.
Gmail MCP server questions
Does Gmail have an official MCP server?
Yes. Gmail publishes its MCP server itself. Gmail's own documentation describes it. MartechDB only lists servers a vendor publishes, never community copies.
What is the Gmail MCP server URL?
The address is https://gmailmcp.googleapis.com/mcp/v1.
Does the Gmail MCP server need an API key?
No, but it needs set-up first: it signs in with OAuth through an app you (or an admin) create in your Gmail account.
How do I connect Gmail MCP to Claude, ChatGPT or Cursor?
In Claude, add https://gmailmcp.googleapis.com/mcp/v1 as a custom connector (Customize, Connectors, Add custom connector). In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http gmail https://gmailmcp.googleapis.com/mcp/v1
What can the Gmail MCP server do?
It offers 23 tools, including create_draft, list_drafts, get_draft, get_thread and get_message (as listed on 22 Nov 2026). 6 are marked read-only and 8 can delete or overwrite data.
Is the Gmail MCP server in the official MCP Registry?
No. Gmail hasn't published it to the official MCP Registry.
Is the Gmail MCP server free to use?
Yes, on a free plan or free quota. Plan needed: Google Workspace Developer Preview Program. Access goes through sales. Limits: 1,200,000 quota units/minute per project, 6,000 per user; charges planned above 80,000,000 units/day. From Gmail's own pages, checked on 8 Oct 2026.
Is the Gmail MCP server working?
Yes. It answered our most recent check. We last checked it on 22 Nov 2026.
What are the alternatives to Gmail's MCP server?
In Workplace communication, the most agent-friendly alternatives with an official MCP server are Superhuman (95/100), Robinpowered (85/100), Fyxer.ai (85/100), Talkspirit (85/100) and SoWork (85/100). Gmail scores 79/100 on the same index.
Alternatives to Gmail's MCP server
Vendors in Workplace communication with an official MCP server, the most agent-friendly first. Gmail scores 79/100.
Superhuman
superhuman.com
Robinpowered
robinpowered.com
Fyxer.ai
fyxer.com
Talkspirit
talkspirit.com
SoWork
sowork.com
Change history
What we've seen change for Gmail, newest first.
-
Gmail: Added to MartechDB with Gmail MCP server
Use with AI
Connect your AI to MartechDB
Then ask it about Gmail, or any of the 1,850 marketing tools with an official MCP server. Free, no sign-in.
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it MartechDB, paste the address below and click Add. There's no sign-in.
The free plan allows one custom connector. On Team and Enterprise plans, an owner adds the connector first.
Claude Code
Run this in your terminal:
ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it MartechDB, paste the address below and choose No authentication.
Developer mode is on Plus and Pro plans, and on Business, Enterprise and Edu if an admin allows it.
API
The same data as JSON, with no sign-in. See the OpenAPI description for every endpoint and field.
CLI
Search the directory and print the command to connect a vendor's server, from your terminal. Needs Node 18 or later. View on npm
Show that your MCP server is verified
If you work at Gmail, add this badge to your MCP docs or README. It's free, it's the same for every vendor, and it updates from our daily checks: it shows uptime while the server responds, and says so if it stops.
Something wrong or out of date? Suggest a correction or email us, and we'll check it against the evidence. Every correction we make is listed on Corrections.