Hosting

Google-managed remote

Transport

Streamable HTTP

Endpoint

https://gmailmcp.googleapis.com/mcp/v1

Authentication

OAuth 2.0. Configure the consent screen and an OAuth client marked “Use this client for an AI-powered agent”; grant only the listed product scopes and sign in with the Google account that should be accessible.

Requirements

• Membership in the Google Workspace Developer Preview Program.
• A Google Cloud project, with the relevant Workspace API and its MCP service enabled.
• A supported remote MCP client and a Google account with access to the target Workspace data.
• OAuth 2.0 consent configuration with these scopes: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose.

Setup steps

1. Join the Google Workspace Developer Preview Program and select/create a Google Cloud project.
2. Enable Gmail API and the matching MCP service in that project.
3. Configure Google Auth Platform consent and add the scopes shown in Requirements.
4. Create an OAuth 2.0 client for an AI agent; use the redirect URI required by your MCP client.
5. Add this server URL to the client: https://gmailmcp.googleapis.com/mcp/v1
6. Authenticate with the intended Google account, grant the requested scopes, refresh the tool list, and verify the listed operations.

Ten tools search/read mail, manage labels and create drafts. Draft creation does not send mail; labels modify mailbox organization. OAuth scopes include gmail.readonly and gmail.compose.

• create_draft

  Officially listed create_draft tool.

  01
• get_message

  Officially listed get_message tool.

  02
• get_thread

  Officially listed get_thread tool.

  03
• label_message

  Officially listed label_message tool.

  04
• label_thread

  Officially listed label_thread tool.

  05
• list_drafts

  Officially listed list_drafts tool.

  06
• list_labels

  Officially listed list_labels tool.

  07
• search_threads

  Officially listed search_threads tool.

  08
• unlabel_message

  Officially listed unlabel_message tool.

  09
• unlabel_thread

  Officially listed unlabel_thread tool.

  10

• Developer Preview

• official source

  Official Google primary MCP reference checked 2026-10-28.

• official source

  Official Google primary MCP reference checked 2026-10-28.

Documentation checked 2026-10-28. Connection has not been runtime tested.