Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Communication - official Google Workspace server

Gmail MCP server

Google-hosted remote MCP server that lets agents search and read Gmail threads and messages, list labels and drafts, create drafts, and apply or remove labels. Google Workspace hosts it at https://gmailmcp.googleapis.com/mcp/v1 with OAuth auth.

Last verified 10 tools3 sources

Install

Google Workspace publishes no copyable client config for this server. Point your MCP client at https://gmailmcp.googleapis.com/mcp/v1. Setup steps are in the vendor's docs.

Tools

search_threads
Search email threads
get_thread
Retrieve a thread
get_message
Retrieve a message
create_draft
Create a draft email
list_drafts
List drafts
list_labels
List labels
label_message
Apply a label to a message
label_thread
Apply a label to a thread
unlabel_message
Remove a label from a message
unlabel_thread
Remove a label from a thread

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Developer Preview: requires membership in the Google Workspace Developer Preview Program, a Google Cloud project with the Gmail API and Gmail MCP API enabled, and an OAuth client marked 'Use this client for an AI-powered agent'.
  • Scopes gmail.readonly and gmail.compose.
  • Claude.ai and Claude Desktop use need an Enterprise, Pro, Max or Team plan (custom connector with OAuth client ID and secret).
  • Google documents an Antigravity mcp_config.json snippet and Claude connector steps, not Claude Code, Codex, Cursor or VS Code snippets.
  • Google lists tool names only; descriptions here are short summaries.

FAQ

What does the Gmail MCP server do?

Google-hosted remote MCP server that lets agents search and read Gmail threads and messages, list labels and drafts, create drafts, and apply or remove labels. The vendor documents 10 tools, including search_threads, get_thread, get_message and create_draft.

How do I install the Gmail MCP server?

Google Workspace publishes no copyable client config. Point your MCP client at https://gmailmcp.googleapis.com/mcp/v1. Setup steps are at https://developers.google.com/workspace/gmail/api/guides/configure-mcp-server.

Does the Gmail MCP server need authentication?

Yes, OAuth. Transport: Streamable HTTP. Status: Preview, last checked October 17, 2026.

Sources

Last verified against 3 Google Workspace pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.