Google Workspace
A comprehensive integration providing 114 tools to manage Google Drive, Docs, Sheets, Slides, Gmail, Calendar, and more through the Model Context Protocol. It enables seamless interaction with the full Google Workspace suite for file management, comm
What is Google Workspace?
Google Workspace is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to comprehensive integration providing 114 tools to manage google drive, docs, sheets, slides, gmail, calendar, and more through the model context protocol. it enables seamless interaction with the full ...
A comprehensive integration providing 114 tools to manage Google Drive, Docs, Sheets, Slides, Gmail, Calendar, and more through the Model Context Protocol. It enables seamless interaction with the full Google Workspace suite for file management, comm
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A comprehensive integration providing 114 tools to manage Go
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @aaronsb/google-workspace-mcpManual Installation
npx -y @aaronsb/google-workspace-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Google Workspace
Google Workspace MCP Server is a comprehensive TypeScript integration that exposes around 80 tools across seven Google services — Gmail, Calendar, Drive, Docs, Sheets, Tasks, and Meet — through the Model Context Protocol. It handles OAuth 2.0 authentication and multi-account credential management automatically, stores credentials securely following the XDG Base Directory Specification, and provides a scratchpad and workspace sandbox for composing multi-step operations. Whether you need to search your inbox, draft documents, update spreadsheet ranges, schedule calendar events, or manage Drive permissions, this server lets you do it all through natural conversation with Claude.
Prerequisites
- Node.js 18+ installed
- A Google Cloud project with OAuth 2.0 credentials (create at console.cloud.google.com/apis/credentials)
- Google APIs enabled for the services you need (Gmail, Calendar, Drive, Sheets, Docs, Tasks, Meet)
- GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET from your OAuth credentials
- An MCP client: Claude Desktop or Claude Code
Create Google Cloud OAuth credentials
Go to console.cloud.google.com → APIs & Services → Credentials → Create Credentials → OAuth 2.0 Client ID. Select Desktop App as the application type. Download the credentials JSON and note the Client ID and Client Secret.
Enable required Google APIs
In the Google Cloud Console, go to APIs & Services → Library and enable each API you plan to use. At minimum enable Gmail API, Google Calendar API, Google Drive API, Google Sheets API, and Google Docs API.
Add the server to Claude Desktop
Edit your claude_desktop_config.json and add the google-workspace block. Use npx to run the package without a global install.
{
"mcpServers": {
"google-workspace": {
"command": "npx",
"args": ["-y", "@aaronsb/google-workspace-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "your-client-secret"
}
}
}
}Authenticate your Google account
Restart Claude Desktop and ask Claude to authenticate. Claude will call the manage_accounts tool which generates an OAuth consent URL. Open that URL in your browser, sign in, and grant the requested permissions.
Verify access by testing a simple query
Ask Claude to list your upcoming calendar events or search your Gmail inbox. Credentials are stored in `~/.local/share/google-workspace-mcp/credentials/` and reused automatically on subsequent runs.
Add additional Google accounts (optional)
The server supports multiple accounts simultaneously. Repeat the authentication step for each account by asking Claude to add another account via the manage_accounts tool.
Google Workspace Examples
Client configuration (Claude Desktop)
Complete Claude Desktop configuration for the Google Workspace MCP server with OAuth credentials.
{
"mcpServers": {
"google-workspace": {
"command": "npx",
"args": ["-y", "@aaronsb/google-workspace-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "123456789-abcdefgh.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "GOCSPX-your-secret-here"
}
}
}
}Prompts to try
Example tasks you can ask Claude to perform across your Google Workspace services.
- "Search my Gmail for unread emails from my manager this week"
- "Create a calendar event for team standup every Monday at 9am"
- "Find all Google Docs shared with me in the last 30 days"
- "Read the Q3 budget spreadsheet and summarize the key figures from the Revenue tab"
- "Draft a reply to the last email from [email protected] and send it"
- "Create a new Google Doc with the meeting notes I'm about to dictate"
- "Check my availability for a 1-hour meeting next Tuesday afternoon"Troubleshooting Google Workspace
OAuth consent screen shows 'app not verified' warning
This appears because the OAuth app is in testing mode. Click 'Advanced' → 'Go to [app name] (unsafe)' to proceed. For production use, publish the OAuth app through Google Cloud Console to remove the warning for end users.
403 errors when accessing Gmail or Calendar APIs
The specific Google API is not enabled in your Cloud project. Go to console.cloud.google.com → APIs & Services → Library and enable the Gmail API, Google Calendar API, or whichever service is failing. Changes take a minute to propagate.
Credentials expire and Claude has to re-authenticate frequently
Google OAuth refresh tokens can expire if the app is in test mode and the token is older than 7 days. Either publish the OAuth app to production mode, or add your account email as a test user in the OAuth consent screen settings to extend the refresh token lifetime.
Frequently Asked Questions about Google Workspace
What is Google Workspace?
Google Workspace is a Model Context Protocol (MCP) server that comprehensive integration providing 114 tools to manage google drive, docs, sheets, slides, gmail, calendar, and more through the model context protocol. it enables seamless interaction with the full google workspace suite for file management, comm It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Google Workspace?
Install via npm with the command: npx -y @aaronsb/google-workspace-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Google Workspace?
Google Workspace works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Google Workspace free to use?
Yes, Google Workspace is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Google Workspace Alternatives — Similar Cloud Services Servers
Looking for alternatives to Google Workspace? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Google Workspace in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Google Workspace?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.