Google Workspace MCP
Gmail, Calendar, Drive, Docs and Sheets tools for coding agents, run locally
- Pricing
- Open source
- Platforms
- vscode, CLI
- Runs
- Locally
- Version
- 26.11.13
- Listing updated
- 2 days ago
About Google Workspace MCP
Google Workspace MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
Sixteen tools sit behind this server: ten for reading and searching, five "admin" tools that group the write actions for each service, and a ping tool that checks the server is alive. That layout lets one request chain services, for example finding a file in Drive, reading it with the Docs tool and drafting a Gmail message about it.
It can be installed as a VS Code extension, which registers itself with eight agents (Copilot, Claude Code, Cursor, Codex, Gemini, Windsurf, Continue.dev and Cline), or run from npm with npx -y @renzo.johnson/google-workspace-mcp in any MCP client. Outside VS Code there is no setup wizard, so the server picks up Google sign-in from environment variables, a key file or gcloud Application Default Credentials. Node.js 22 or newer is needed.
Destructive actions such as deleting a file, trashing an email, removing document text or clearing a cell range only run when confirm: true is passed, so the agent has to ask first. The author says the server runs on your machine, talks only to Google's APIs and has no telemetry. It is an independent project, not Google's official Workspace MCP server, and it is a local server for coding agents rather than a connector for the Claude web app.
Install
Run in a terminal
claude mcp add google-workspace-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-workspace-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"google-workspace-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-workspace-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"google-workspace-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-workspace-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"google-workspace-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-workspace-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-workspace-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-workspace-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"google-workspace-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-workspace-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Configuration
GOOGLE_APPLICATION_CREDENTIALSPath to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables.GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Gmail, Calendar, Drive, Docs and Sheets scopes.
Tools this server provides (10)
Taken from the project documentation; the running server may differ.
- gmail_list
- List Gmail messages
- gmail_read
- Read a Gmail message
- gmail_search
- Search Gmail
- gmail_send
- Send an email
- calendar_list_events
- List Google Calendar events
- calendar_get_event
- Get one calendar event
- drive_list
- List Drive files
- drive_search
- Search Drive
- docs_read
- Read a Google Doc
- sheets_read
- Read a Google Sheet
What it does
- One server, five services
- Gmail, Calendar, Drive, Docs and Sheets share a single install.
- Confirmation on destructive actions
- Deletes, trashing and range clears require an explicit confirm flag.
- Three sign-in methods
- OAuth 2.0, gcloud Application Default Credentials or a service account key.
- Automatic agent registration
- The VS Code extension writes config for eight agents and can be toggled per agent.
- Runs without VS Code
- The npm package works in Claude Code, Cursor or any MCP client.
- Pick only the APIs you need
- A service whose API you did not enable returns a permission error while the rest keep working.
Good for
- Summarise unread email and today's meetings from the editor
- Find a spreadsheet in Drive and append a row to it
- Draft a Gmail reply and book a Calendar slot in one request
- Read a project proposal Doc and pull out action items
Pricing
Open source
Free and MIT licensed.
Prices change. Check renzojohnson.com before you buy.
Google Workspace MCP FAQ
Is it Google's official Workspace MCP server?
No. It is an independent extension that calls Google's public APIs with your own sign-in.
Does it need a paid Workspace account?
No. OAuth works with a free personal Google account; only the service account method needs a Workspace admin.
Where does my data go?
The server runs on your machine and calls Google's APIs with your credentials. The author states there is no telemetry and the token is kept in VS Code's encrypted secret storage.
Which licence does it use?
MIT.
Is Google Workspace MCP free?
Yes. Google Workspace MCP is open source, so you can use and self-host it for free.
How do I add Google Workspace MCP to Claude Code?
Run this command in your terminal: claude mcp add google-workspace-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-workspace-mcp
What are the best alternatives to Google Workspace MCP?
The closest alternatives to Google Workspace MCP are Ha MCP, Concord MCP, note1, BoardAgent and Callout.
Alternatives to Google Workspace MCP

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media