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. 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. Add a custom MCP server
On ChatGPT web, open Plugins, select +, then Add custom MCP server.
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. 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.
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.Do I need an API key to connect Gmail to ChatGPT?
No. You sign in to Gmail once through Metorial, and ChatGPT uses that connection. No API keys go into ChatGPT's settings.Which Gmail tools can ChatGPT use?
All 18 Gmail tools your team allows, such as Modify Message, Manage Settings, Manage Draft. Admins can narrow that list per team.Can I control which teammates use Gmail in ChatGPT?
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.What if ChatGPT doesn't show Gmail tools?
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.
Confluence
Asana