Used for configuration management, especially for storing Google OAuth credentials and custom scope settings
Used to clone and manage the MCP server repository
Provides email composition and sending capabilities with automatic contact resolution, reading emails, and managing labels
Enables interaction with Google Workspace, allowing for smart contact resolution across Google services
Allows file management, sharing with automatic contact resolution, and access to shared drives
Provides access to Google Sheets with optional expanded permissions
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-mcp-serversend an email to Spencer about tomorrow's meeting"
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 MCP Server
Connect Claude to your Google Workspace with intelligent contact resolution and secure OAuth2 authentication
Transform Claude into your Google productivity assistant. Send emails to "John Smith" instead of john.smith@company.com, share files by name, and create calendar events with automatic attendee resolution.
✨ Key Features
🧠 Smart Contact Resolution:
send email to Spencer Varney about the meeting→ automatically finds spencer.varney@company.com🔒 Secure by Default: Uses restricted scopes compatible with Google Advanced Protection
📱 50+ Tools: Complete Gmail, Drive, Calendar integration with shared drive support
⚡ Safety First: All send/share operations require explicit confirmation
Related MCP server: Google Maps MCP Server
🚀 Quick Start
1. Install
2. Configure Google
Create a Google Cloud project and enable APIs (Drive, Gmail, Calendar, People)
Create OAuth2 credentials (Desktop application type)
Copy your credentials to
.env:
3. Add to Claude Desktop
Add to claude_desktop_config.json:
💡 Examples
Smart Email (resolves contacts automatically):
Safe File Sharing (shows preview, requires confirmation):
Calendar with Attendees (resolves multiple contacts):
🔐 Security & Scopes
This server uses intentionally restrictive OAuth scopes for maximum security by default. These scopes are compatible with Google Advanced Protection Program and follow the principle of least privilege.
Default Scopes (Security-First)
drive.file- Only files created by this app (not full Drive access)gmail.send+gmail.readonly+gmail.labels- Send, read, and manage labelscontacts.readonly- Read contacts for smart name resolutioncalendar- Full calendar access (Google doesn't offer restricted calendar scopes)
Expanding Permissions
If you need broader access, add scopes to your .env file:
Security Note: The default restricted scopes protect your account even if credentials are compromised. Only expand permissions if you specifically need the additional functionality.
File: Scopes are defined in src/google_mcp_server/auth.py (DEFAULT_SCOPES)
📚 Documentation
Complete Setup Guide - Detailed Google Cloud Console configuration
All Tools Reference - Complete list of 50+ available tools
Usage Examples - Common workflows and advanced usage
Troubleshooting - Solutions for common issues
🛡️ Safety Features
All potentially dangerous operations use a two-step confirmation process:
Prepare:
prepare_send_email()→ Shows preview, resolves contactsConfirm:
confirm_send_email()→ Actually sends after your approval
No emails, file shares, or calendar invites are sent without explicit confirmation.
🤝 Contributing
Fork the repository
Create a feature branch
Add tests for new functionality
Submit a pull request
📄 License
MIT License - see LICENSE file for details.
Questions? Check the documentation or open an issue.