How to connect Gmail to ChatGPT

  • ChatGPT gets 18 Gmail tools through one Metorial MCP URL.
  • Setup is 4 steps; teammates then sign in with SSO.
  • You need a ChatGPT plan or workspace that allows custom MCP servers.

What ChatGPT can do with Gmail

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Ask ChatGPT to use the search messages tool in Gmail
  • Ask ChatGPT to use the get message tool in Gmail
  • Ask ChatGPT to use the send email tool in Gmail
  • Ask ChatGPT to use the get attachment tool in Gmail
  • Ask ChatGPT to use the search google contacts tool in Gmail

Add the Gmail MCP server to ChatGPT

Run these once. Afterwards, everyone you give access to signs in the same way.

  1. 1. Enable Gmail in Metorial

    In your Metorial portal, enable the Gmail MCP server and sign in with the account that owns the data. Access stays governed by your team policies.

  2. 2. Add a custom MCP server

    On ChatGPT web, open Plugins, select +, then Add custom MCP server.

  3. 3. Paste your Metorial MCP URL

    Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.

  4. 4. Create and install the plugin

    Select Create as a plugin, install it and sign in to load Gmail tools.

Give your team Gmail in ChatGPT

Once Gmail is enabled in Metorial, teammates sign in with SSO and get the same connection in ChatGPT, with only the tools their role allows.

One link covers every app you approve. See how the MCP gateway handles access, roles and audit logs for the whole company.

Gmail tools available in ChatGPT

Full descriptions and inputs are on the Gmail MCP server page.

  • Modify Message: Modify a message's labels, move it to trash, or restore it from trash.
  • Manage Settings: View and manage Gmail settings including vacation responder (auto-reply), IMAP, POP, display language, mail filters, forwarding addresses, auto-forwarding status, and send-as alia…
  • Manage Draft: Create, update, send, list, get, or delete email drafts.
  • Manage Labels: List, create, update, get, or delete Gmail labels.
  • Manage Thread: Get, list, modify labels, trash, or restore email conversation threads.
  • Search Messages: Search and list email messages using Gmail query syntax.
  • Get Message: Retrieve a single email message by its ID.
  • Send Email: Send an email message to one or more recipients.
  • Get Attachment: Download an email attachment by its ID.
  • Search Google Contacts: Searches the authenticated user's Google Contacts from the People API by name, email address, phone number, or other fields.
  • List Google Contacts: Lists the authenticated user's Google Contacts from the People API with pagination support.
  • Get Google Contact: Retrieves detailed Google Contacts information for a People API resource name.
  • Delete Messages Permanently: Immediately and permanently delete one or more Gmail messages.
  • Delete Thread Permanently: Immediately and permanently delete a Gmail thread and all messages in it.
  • Forward Message: Forward an existing Gmail message to new recipients while preserving its complete MIME body and attachments.
  • And 3 more on the Gmail MCP server page.

Using Gmail tools in ChatGPT

What to expect once Gmail is connected.

  • Type @ and pick the plugin. The selection applies to that message only, so @mention it again when a follow-up needs fresh Gmail data.
  • For write actions, ChatGPT may ask you to confirm first, depending on the app permissions and the action.
  • Once published for a workspace, ChatGPT keeps a snapshot of the tool list. When your team adds Gmail tools in Metorial, an admin refreshes the actions in Workspace settings before they appear.
  • You can use several apps in one prompt, for example read Gmail data and then create a ticket in another app.

Troubleshooting ChatGPT

Add custom MCP server is missing
Workspace policy controls it. On Enterprise and Edu, an admin grants the permission to create plugins with MCPs; ask them to enable it for you.
The plugin exists but no tools appear
Creating the plugin is not enough: install it from your plugins, then start a new conversation so ChatGPT loads its tools.
ChatGPT answers without using the tools
Pick the plugin with @ in the composer and name the action you want, for example "use Metorial to look up the latest ticket".

Based on the ChatGPT MCP documentation.

Frequently asked questions

Common questions about connecting Gmail to AI agents with Metorial.

  1. Does ChatGPT support the Gmail MCP server?
    Yes. ChatGPT connects to the Gmail MCP server through its connector settings, pointed at your Metorial URL. You need a ChatGPT plan or workspace that allows custom MCP servers.
  2. No. You sign in to Gmail once through Metorial, and ChatGPT uses that connection. No API keys go into ChatGPT's settings.
  3. All 18 Gmail tools your team allows, such as Modify Message, Manage Settings, Manage Draft. Admins can narrow that list per team.
  4. Yes. Role-based access control decides who can use Gmail and which of its tools appear in ChatGPT, and every call is logged with the person's identity.
  5. Workspace policy controls it. On Enterprise and Edu, an admin grants the permission to create plugins with MCPs; ask them to enable it for you.