Skip to content
Back to search
100
MCP live MCP 2026-07-28 streamable-http

Gmail

com.googleapis.gmailmcp/gmail

Connect Gmail to Claude to quickly find important emails and understand long conversations. Claude can search through your messages, read entire email threads to give you context, and help you stay on top of your inbox. Perfect for finding that message you remember sending, catching up on email chains you missed, or preparing for meetings.

Listed in Claude connectors
Watch this dependency Share evidence report
Uptime
100.0%
4 direct probes · 30d
Response
919ms
last probe
Tools
23
callable
Resources
0
readable
Prompts
0
available
Score: 100/100
Handshake verified by our own probe.
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
23 tools, 0 resources, 0 prompts returned.
pass 3 or more catalogue items 10/10
23 items in total; 3 or more earns these points.
pass Describes itself 10/10
341 characters; more than 30 earns these points.

Tools · 23

create_draft

Creates 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 p…

list_drafts

Lists 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_draft

Retrieves 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 control…

get_thread

Retrieves 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 ret…

get_message

Retrieves 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 …

search_threads

Lists 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`,…

label_thread

Adds 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…

unlabel_thread

Removes 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…

apply_sensitive_thread_label

Prefer `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…

trash_thread

Moves 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_m…

untrash_thread

Removes an entire thread from the Trash in the authenticated user's Gmail account.

mark_thread_spam

Marks 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…

unmark_thread_spam

Unmarks an entire thread as Spam in the authenticated user's Gmail account.

list_labels

Lists 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_threa…

label_message

Adds 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 …

update_message_labels

Atomically 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 bet…

unlabel_message

Removes 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` t…

apply_sensitive_message_label

Prefer `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 …

trash_message

Moves 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…

untrash_message

Removes a specific message from the Trash in the authenticated user's Gmail account. To find the message ID, use the `get_thread` tool.

mark_message_spam

Marks a specific message as Spam in the authenticated user's Gmail account. To find the message ID, use the `get_thread` tool.

unmark_message_spam

Unmarks a specific message as Spam in the authenticated user's Gmail account. To find the message ID, use the `get_thread` tool.

create_label

Creates 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 a…

How to use

Claude Desktop or claude.ai: add a custom connector (Customize → Connectors; on Team and Enterprise plans an owner adds it under Organization settings → Connectors) with this server URL: https://gmailmcp.googleapis.com/mcp/v1

Cursor or Cline: add to your MCP config:

{
  "mcpServers": {
    "gmail": {
      "url": "https://gmailmcp.googleapis.com/mcp/v1",
      "transport": "streamable-http"
    }
  }
}