Google Suite
MCP server for Gmail, Google Calendar, and Google Drive integration using fastmcp. Supports multiple accounts, email management, calendar events, and file operations.
What is Google Suite?
Google Suite is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for gmail, google calendar, and google drive integration using fastmcp. supports multiple accounts, email management, calendar events, and file operations.
MCP server for Gmail, Google Calendar, and Google Drive integration using fastmcp. Supports multiple accounts, email management, calendar events, and file operations.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for Gmail, Google Calendar, and Google Drive inte
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx fastmcp-gsuiteConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Google Suite
The fastmcp-gsuite MCP server connects Claude to Gmail, Google Calendar, and Google Drive using OAuth2 and the official Google APIs. It supports multiple Google accounts simultaneously and exposes tools for reading and drafting emails, managing calendar events, and working with Drive files — all from within a single Claude conversation.
Prerequisites
- Python 3.10 or later and uv (pip install uv) or pip
- A Google Cloud project with the Gmail, Calendar, and Drive APIs enabled
- An OAuth2 client credentials JSON file (client_secret_*.json) downloaded from Google Cloud Console
- A Claude desktop client that supports MCP (Claude Desktop or compatible)
Install the package
Install fastmcp-gsuite from PyPI using uv or pip.
uv pip install fastmcp-gsuite
# or
pip install fastmcp-gsuiteRun first-time Google OAuth setup
The setup command guides you through authorizing one or more Google accounts and writes credential files to disk.
uv run fastmcp-gsuite-setupCreate a .env file with paths
Create a .env file (or set environment variables) pointing at your OAuth client config, accounts file, and credentials directory.
GAUTH_FILE=/Users/you/.gsuite/gauth.json
ACCOUNTS_FILE=/Users/you/.gsuite/accounts.json
CREDENTIALS_DIR=/Users/you/.gsuite/credentialsTest the server locally
Confirm the server starts without errors before wiring it into Claude Desktop.
uv run fastmcp-gsuiteAdd the server to Claude Desktop config
Register fastmcp-gsuite in claude_desktop_config.json with the environment variables pointing to your credential files.
{
"mcpServers": {
"gsuite": {
"command": "uv",
"args": ["run", "fastmcp-gsuite"],
"env": {
"GAUTH_FILE": "/Users/you/.gsuite/gauth.json",
"ACCOUNTS_FILE": "/Users/you/.gsuite/accounts.json",
"CREDENTIALS_DIR": "/Users/you/.gsuite/credentials"
}
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop and ask it to retrieve your latest emails to confirm Google API access is working.
Google Suite Examples
Client configuration
Complete claude_desktop_config.json snippet for the fastmcp-gsuite MCP server.
{
"mcpServers": {
"gsuite": {
"command": "uv",
"args": ["run", "fastmcp-gsuite"],
"env": {
"GAUTH_FILE": "/Users/you/.gsuite/gauth.json",
"ACCOUNTS_FILE": "/Users/you/.gsuite/accounts.json",
"CREDENTIALS_DIR": "/Users/you/.gsuite/credentials"
}
}
}
}Prompts to try
Natural-language requests you can send to Claude after connecting the server.
- "Retrieve my latest unread messages"
- "Search my emails from the Scrum Master"
- "Write a polite response to Alice's last email and save it as a draft"
- "What do I have on my calendar tomorrow?"
- "Create a 2-hour meeting with Tim next Tuesday at 10am"
- "Check my secondary account's Family calendar for next week"Troubleshooting Google Suite
OAuth setup fails with 'redirect_uri_mismatch'
In Google Cloud Console, add http://localhost to the list of Authorized Redirect URIs for your OAuth2 client. The setup command uses a local redirect to capture the authorization code.
Server starts but returns 'invalid_grant' errors during API calls
The stored OAuth tokens have expired or been revoked. Delete the files in CREDENTIALS_DIR and re-run uv run fastmcp-gsuite-setup to obtain fresh tokens.
Multiple accounts: only the first account's data is returned
Verify that accounts.json lists all account identifiers and that a corresponding credential file exists in CREDENTIALS_DIR for each. Each account must be authorized individually during setup.
Frequently Asked Questions about Google Suite
What is Google Suite?
Google Suite is a Model Context Protocol (MCP) server that mcp server for gmail, google calendar, and google drive integration using fastmcp. supports multiple accounts, email management, calendar events, and file operations. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Google Suite?
Follow the installation instructions on the Google Suite GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Google Suite?
Google Suite works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Google Suite free to use?
Yes, Google Suite is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Google Suite Alternatives — Similar Communication Servers
Looking for alternatives to Google Suite? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Google Suite 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 Suite?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.