Google Workspace MCP server
betaGoogle offers one hosted MCP server per Workspace product, including Gmail, Drive, Calendar, Docs, Sheets and Chat. They are part of Google's Developer Preview and inherit the user's permissions and data governance.
What an agent can do
- → Search email and create drafts
- → Search, read and create Drive files
- → Manage calendar events
- → Read and update Docs and Sheets
- → Search and send Chat messages
The servers require membership in Google's Developer Preview Program and a Google Cloud project with the APIs and MCP services enabled.
About the Google Workspace MCP server
Google runs one hosted MCP server for each Workspace product instead of a single shared one: Gmail, Drive, Docs, Sheets, Slides, Calendar, Chat, People and Classroom each have their own address at googleapis.com. The servers are part of the Google Workspace Developer Preview Program, which means early access for developers. Using them requires membership in that program and a Google Cloud project of your own.
A team uses the servers to let an AI assistant find an email thread and draft a reply, search for and read files in Drive, read and update documents, spreadsheets and presentations, find free time slots and book meetings in the calendar, or search and send messages in Chat. The People server looks up contacts and colleagues in the directory.
The servers use OAuth 2.0 and inherit the same permissions and data governance controls as the user. Which parts the assistant reaches is decided by the scopes you add for each product. Google warns that a connected client can read, modify and delete data in the account, and advises using only trusted applications and reviewing every action the assistant takes.
Things to ask
- Find the email thread about the supplier contract and draft a reply.
- What is in my calendar tomorrow, and when are Anna and I both free?
- Summarise the third-quarter budget sheet and add a row for October.
- Find the latest version of the onboarding document in Drive.
Tools the server exposes
- search_threads
- get_thread
- create_draft
- search_files
- read_file_content
- create_file
- read_doc
- update_doc
- get_values
- update_values
- list_events
- create_event
- suggest_time
- search_messages
- send_message
- search_contacts
How to connect Google Workspace
- Join the Google Workspace Developer Preview Program.
- Create a Google Cloud project and enable both the product APIs and the matching MCP services, for example gmailmcp.googleapis.com. For the Chat server, also configure a Chat app in the Google Chat API configuration.
- Configure the OAuth consent screen and scopes, and create a web application OAuth client with Use this client for an AI-powered agent selected.
- In Claude, add one custom connector per product and enter the client ID and secret under advanced settings. This needs Claude Pro, Max, Team or Enterprise.
Part of these packages
Google Workspace is part of these Walma packages.
Questions about Google Workspace MCP
Does Google have an official MCP server for Gmail and Drive?+
Yes. Google runs one hosted server per product: Gmail, Drive, Docs, Sheets, Slides, Calendar, Chat, People and Classroom. They are part of the Google Workspace Developer Preview Program, which means early access.
What are the server URLs?+
Each product has its own: https://gmailmcp.googleapis.com/mcp/v1 for Gmail, https://drivemcp.googleapis.com/mcp/v1 for Drive and https://calendarmcp.googleapis.com/mcp/v1 for Calendar. Docs, Sheets, Slides and Chat follow the same pattern. People is at https://people.googleapis.com/mcp/v1.
Can the Gmail server send email?+
The documented Gmail tools search and read threads, create drafts and manage labels. Sending is not among the listed tools, so a person sends the draft.
Which AI assistants do they work with?+
Google documents Antigravity and Claude in detail. Claude needs a Pro, Max, Team or Enterprise plan. Other clients connect over Streamable HTTP with OAuth 2.0.
What does an administrator control?+
The servers inherit the user's permissions and the same data governance controls. Administrators can review OAuth log events in the security investigation tool. Google's page states neither pricing nor quotas.
Why do I have to sign in again about every hour?+
This happens when the client has no refresh token. Google only issues one when the authorisation request includes access_type=offline. Asking for the offline_access scope is not enough. If the user has already consented, prompt=consent is also needed to get a new one. If your client cannot set custom parameters, users have to sign in again each time the access token expires.
What security risks does Google point out?+
Google warns about indirect prompt injection: an email or document from an unknown sender can contain hidden instructions that the assistant follows. Because a connected client can read, modify and delete data in the account, Google advises using only trusted and verified applications, being careful with content from unverified sources, and reviewing every action the assistant takes on your behalf.
Missing a connection?
We build and review MCP servers for teams that need them, and run them behind the same policy and log as the rest of the gateway.