# Gmail (Google) (MCP Server)

> Google's official Gmail MCP server for searching threads, drafting, and labels

- Type: MCP server
- Publisher: Google (official)
- Categories: Communication, Productivity
- Website: https://developers.google.com/workspace/gmail/api/reference/mcp
- Docs: https://developers.google.com/workspace/guides/configure-mcp-servers
- Transport: streamable-http
- Server URL: https://gmailmcp.googleapis.com/mcp/v1
- Sign-in: oauth
- Listed: 2026-04-01

## About

Google's managed Gmail MCP server lets AI agents search and read threads and messages, create drafts, and manage labels. It is part of the Google Workspace Developer Preview Program and requires enabling the MCP service in a Google Cloud project and configuring an OAuth 2.0 client.

## Install

1. **Connect it in ChatGPT** Turn on Developer mode in ChatGPT (Settings → Security and login), open Plugins, select + and paste https://gmailmcp.googleapis.com/mcp/v1 as the MCP server URL, then sign in with OAuth. Add it to a chat from the composer's tools menu.

2. **Or add it to Codex or the API**

   Codex CLI:

   ```bash
   codex mcp add gmail --url https://gmailmcp.googleapis.com/mcp/v1
   codex mcp login gmail
   ```

   config.toml:

   ```toml
   [mcp_servers.gmail]
   url = "https://gmailmcp.googleapis.com/mcp/v1"
   ```

   Responses API:

   ```python
   import os
   from openai import OpenAI
   
   client = OpenAI()
   
   response = client.responses.create(
       model="gpt-6-astra",
       tools=[{
           "type": "mcp",
           "server_label": "gmail",
           "server_url": "https://gmailmcp.googleapis.com/mcp/v1",
           "authorization": os.environ["GMAIL_API_KEY"],
           "require_approval": "never",
       }],
       input="Search my Gmail for invoices from last month",
   )
   print(response.output_text)
   ```

## Tools

- `search_threads`
- `get_thread`
- `get_message`
- `create_draft`
- `list_drafts`
- `list_labels`
- `create_label`
- `label_thread`
- `unlabel_thread`
- `label_message`
- `unlabel_message`

## Example prompts

- "Search my Gmail for invoices from last month"
- "Draft a reply to the latest email from Sarah about the offsite"
- "Label all threads from the vendor as 'Procurement'"
- "Summarize the thread about the contract renewal"

## Also available as

- plugin: [Google Drive](https://chatgptplugins.directory/plugins/google-drive.md)

## Related

- [Notion](https://chatgptplugins.directory/mcp/notion.md): Search, read, and write Notion pages, databases, and comments via hosted MCP
- [Excalidraw](https://chatgptplugins.directory/mcp/excalidraw.md): Draw hand-drawn Excalidraw diagrams live inside ChatGPT, Claude and VS Code
- [Atlassian Rovo (Jira & Confluence)](https://chatgptplugins.directory/mcp/atlassian-rovo.md): Work with Jira issues and Confluence pages through Atlassian's hosted MCP
- [Browser Use](https://chatgptplugins.directory/mcp/browser-use.md): Run Browser Use cloud browser agents or control a local browser over MCP
- [Filesystem](https://chatgptplugins.directory/mcp/filesystem.md): Secure local file operations with configurable directory access
- [Memory](https://chatgptplugins.directory/mcp/memory.md): Knowledge graph-based persistent memory across conversations

---
Source: https://chatgptplugins.directory/mcp/gmail · Index: https://chatgptplugins.directory/llms.txt · Independent and community-run. Not affiliated with or endorsed by OpenAI. ChatGPT is a trademark of OpenAI.