Google Gsuite
MCP Server to interact with Google Gsuite prodcuts
What is Google Gsuite?
Google Gsuite is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server to interact with google gsuite prodcuts
MCP Server to interact with Google Gsuite prodcuts
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Server to interact with Google Gsuite prodcuts
Use Cases
Maintainer
Works with
Installation
NPM
npx -y mcp-gsuiteManual Installation
npx -y mcp-gsuiteConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Google Gsuite
mcp-gsuite is a Python-based MCP server that connects AI assistants to Google Workspace (formerly G Suite) products, currently supporting Gmail and Google Calendar. It enables reading, searching, and drafting emails, creating and querying calendar events, and managing multiple Google accounts through a single server instance using OAuth2 authentication. Teams and individuals who manage their email and schedule through Google Workspace can use this server to let Claude or other AI assistants read context from their inbox, schedule meetings, or draft replies entirely through natural language.
Prerequisites
- Python 3.10 or later with uv package manager installed
- A Google Cloud project with the Gmail API and Google Calendar API enabled
- OAuth2 client credentials (client_id and client_secret) from Google Cloud Console
- An MCP-compatible client such as Claude Desktop
- Node.js 18+ (for Smithery-based installation) or uv (for direct Python install)
Create a Google Cloud project and enable APIs
Go to console.cloud.google.com, create a project, and enable the Gmail API and Google Calendar API. Under Credentials, create an OAuth 2.0 Client ID of type 'Desktop app' and download the JSON credentials.
Create the .gauth.json configuration file
Save your OAuth2 credentials as .gauth.json in the directory where the server will run. Include the required Google API scopes.
{
"web": {
"client_id": "your_client_id.apps.googleusercontent.com",
"client_secret": "your_client_secret",
"redirect_uris": ["http://localhost"],
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token"
},
"scopes": [
"openid",
"https://mail.google.com/",
"https://www.googleapis.com/auth/calendar",
"https://www.googleapis.com/auth/userinfo.email"
]
}Create the .accounts.json file
List the Google accounts this server should manage. Each entry specifies the email and account type.
[
{
"email": "[email protected]",
"account_type": "personal"
}
]Install and run the server
Install mcp-gsuite via Smithery or run it directly with uv/Python. The first run will open a browser for OAuth2 consent — complete the authorization flow.
npx -y @smithery/cli install mcp-gsuite --client claude
# OR run directly:
uv run mcp-gsuiteAdd the server to your MCP client configuration
Add the mcp-gsuite entry to your claude_desktop_config.json pointing to the installed server with the paths to your auth files.
{
"mcpServers": {
"mcp-gsuite": {
"command": "npx",
"args": ["-y", "mcp-gsuite"]
}
}
}Google Gsuite Examples
Client configuration
Claude Desktop config for mcp-gsuite installed via Smithery.
{
"mcpServers": {
"mcp-gsuite": {
"command": "npx",
"args": ["-y", "mcp-gsuite"]
}
}
}Prompts to try
Natural language prompts you can use once mcp-gsuite is connected to your AI assistant.
- "Retrieve my latest unread messages"
- "What do I have on my agenda tomorrow?"
- "Write a nice response to Alice's last email and save it as a draft"
- "Show me all emails from [email protected] in the last week"
- "Create a calendar event for a team standup at 10am next Monday with the whole team"
- "Delete all draft emails I haven't sent in the last month"Troubleshooting Google Gsuite
OAuth2 consent flow fails or redirects to 'This app is blocked'
In Google Cloud Console, add your Google account as a test user under OAuth consent screen → Test users. The app must be in testing mode with explicitly listed test users until it is published.
Server starts but returns 'Insufficient Permission' errors for Gmail or Calendar
Ensure all four required OAuth scopes are listed in .gauth.json: openid, https://mail.google.com/, https://www.googleapis.com/auth/calendar, and https://www.googleapis.com/auth/userinfo.email. Delete any cached token files and re-authenticate.
Multiple accounts in .accounts.json but only one works
Each account must complete its own OAuth2 authorization flow. Run the server once per account and complete the browser consent for each email address listed in .accounts.json.
Frequently Asked Questions about Google Gsuite
What is Google Gsuite?
Google Gsuite is a Model Context Protocol (MCP) server that mcp server to interact with google gsuite prodcuts It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Google Gsuite?
Install via npm with the command: npx -y mcp-gsuite. 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 Gsuite?
Google Gsuite works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Google Gsuite free to use?
Yes, Google Gsuite is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Google Gsuite Alternatives — Similar Cloud Services Servers
Looking for alternatives to Google Gsuite? 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 Gsuite 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 Gsuite?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.