This project provides an MCP (Model Context Protocol) server for interacting with Google Workspace products, specifically Gmail and Google Calendar. It enables AI models to query emails, manage drafts, handle attachments, and schedule/manage calendar events, offering a powerful integration for productivity workflows.

How It Works

The server leverages Google's OAuth 2.0 for secure authentication and authorization, requiring specific scopes for Gmail and Calendar access. It uses a JSON configuration file (.gauth.json) for client credentials and another (.accounts.json) to define user accounts and provide contextual information to the AI. Upon first use, it initiates a browser-based OAuth flow, storing refresh tokens locally for subsequent access.

Quick Start & Requirements

• Install: npx -y @smithery/cli install mcp-gsuite --client claude
• Prerequisites: Google Cloud project with Gmail and Calendar APIs enabled, OAuth 2.0 client ID (Desktop app or Web application), Python.
• Authentication Setup: Requires creating OAuth 2.0 credentials, configuring the consent screen, and setting up .gauth.json and .accounts.json files.
• Resources: Local storage for credentials (.oauth.{email}.json).
• Docs: Google Cloud Console, MCP Inspector

Highlighted Details

• Supports multiple Google accounts with customizable descriptions for AI context.
• Enables flexible email querying (unread, date ranges, sender, attachments) and draft management.
• Allows saving multiple attachments from emails to the local system.
• Calendar management includes event creation with optional location, description, attendees, and custom timezones.

Maintenance & Community

The project is maintained by MarkusPfundstein. Further community or maintenance details are not explicitly provided in the README.

Licensing & Compatibility

The README does not specify a license. Compatibility for commercial use or closed-source linking is not detailed.

Limitations & Caveats

Debugging MCP servers can be challenging; the project recommends using the MCP Inspector. Log files for the server are available at ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log on macOS.