Google Workspace MCP Server
Search, read, send, draft, label, and manage email through the Gmail API.
Execute and manage Google Apps Script projects.
Create, update, delete events; check availability; RSVP through the Google Calendar API.
Send messages, manage spaces through the Google Chat API.
Create, read, edit, and format documents through the Google Docs API.
Search, upload, download, organize files and folders through the Google Drive API.
Create forms, manage questions, read responses through the Google Forms API.
Read and write cell ranges, manage spreadsheets through the Google Sheets API.
Create and edit presentations, extract content through the Google Slides API.
Manage task lists and individual tasks through the Google Tasks API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Google Workspace MCP Serverlist unread emails from yesterday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Google Workspace MCP Server — Personal Cloud Run Deployment
A personal remote MCP server providing full natural language control over Google Workspace, hosted on Google Cloud Run. Based on taylorwilsdon/google_workspace_mcp (v1.14.3).
Live Service
MCP Endpoint |
|
Health Check |
|
Transport | Streamable HTTP (MCP over HTTP) |
Account |
Related MCP server: Google Drive MCP Server
Connecting to Claude Code
Add to ~/.claude/mcp.json:
{
"mcpServers": {
"google-workspace": {
"type": "http",
"url": "https://google-workspace-mcp-557522843498.us-central1.run.app/mcp"
}
}
}Restart Claude Code to load the server.
Enabled Google Workspace Tools
All major Google Workspace services are available:
Service | Capabilities |
Gmail | Search, read, send, draft, label, and manage email |
Google Calendar | Create, update, delete events; check availability; RSVP |
Google Drive | Search, upload, download, organize files and folders |
Google Docs | Create, read, edit, and format documents |
Google Sheets | Read and write cell ranges, manage spreadsheets |
Google Slides | Create and edit presentations, extract content |
Google Forms | Create forms, manage questions, read responses |
Google Tasks | Manage task lists and individual tasks |
Google Chat | Send messages, manage spaces |
Contacts | Look up and manage contacts via People API |
Apps Script | Execute and manage Google Apps Script projects |
Custom Search | Programmable Search Engine integration (requires PSE key) |
Infrastructure
Resource | Details |
GCP Project | tom-personal-tools |
Cloud Run Region | us-central1 (within always-free tier) |
Runtime | Python 3.11 on Cloud Run managed |
Auth | OAuth 2.1, Desktop OAuth client |
Secrets | Google Secret Manager ( |
CI/CD | Cloud Build trigger on push to |
Container Registry | Artifact Registry ( |
Redeploying Manually
cd /home/tom-unix/projects/google-workspace-mcp
gcloud run deploy google-workspace-mcp \
--source . \
--project=tom-personal-tools \
--region=us-central1 \
--platform=managed \
--allow-unauthenticated \
--port=8000 \
--memory=512Mi \
--set-secrets="GOOGLE_OAUTH_CLIENT_ID=GOOGLE_OAUTH_CLIENT_ID:latest,GOOGLE_OAUTH_CLIENT_SECRET=GOOGLE_OAUTH_CLIENT_SECRET:latest" \
--set-env-vars="MCP_ENABLE_OAUTH21=true,USER_GOOGLE_EMAIL=tschreiter@gmail.com" \
--timeout=300Pushes to main trigger automatic redeployment via Cloud Build.
Pulling Upstream Updates
git fetch upstream
git log HEAD..upstream/main --oneline # preview changes
git merge upstream/main
git pushCloud Build will automatically deploy the updated version.
Rotating OAuth Credentials
echo -n "NEW_CLIENT_ID" | gcloud secrets versions add GOOGLE_OAUTH_CLIENT_ID \
--data-file=- --project=tom-personal-tools
echo -n "NEW_CLIENT_SECRET" | gcloud secrets versions add GOOGLE_OAUTH_CLIENT_SECRET \
--data-file=- --project=tom-personal-toolsThen redeploy to pick up the new versions.
Upstream
This deployment tracks taylorwilsdon/google_workspace_mcp.
Local changes are limited to CLAUDE.md, cloudbuild.yaml, and this README.md.
License: MIT (upstream)
This server cannot be installed
Maintenance
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tom275275/google-workspace-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server