mcp-gsuite-enhanced

Name: mcp-gsuite-enhanced
Author: ajramos

@ajramos

Repository

About mcp-gsuite-enhanced

Enhanced MCP server for Google Workspace with Google Meet integration and bug fixes

#mcp-gsuite #google-workspace #email-management

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-gsuite-enhanced": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-gsuite-enhanced?

mcp-gsuite-enhanced is an MCP server for Google Workspace that provides complete Gmail API coverage (22 tools) and Google Calendar integration (5 tools) with automatic Google Meet links. It is an enhanced fork of the original mcp-gsuite, offering advanced email management, label operations, archive workflows, and working calendar updates.

How to use mcp-gsuite-enhanced?

Clone the repository, install dependencies with uv sync, set up Google Cloud OAuth 2.0 credentials (saved as .gauth.json), configure your accounts in .accounts.json, then run python auth_setup.py <email> to authenticate. Use python cursor_setup.py to generate Cursor IDE configuration, or manually add the MCP server definition to your client (e.g., Claude Desktop) with the command uv --directory /path/to/mcp-gsuite-enhanced run mcp-gsuite-enhanced.

Key features of mcp-gsuite-enhanced

Complete Gmail API coverage with 27 total tools (22 Gmail + 5 Calendar)
Send emails with CC/BCC support and flexible search queries
Full label management: create, apply, remove, and delete labels
Archive workflows: archive, restore, and bulk archive emails
Draft management: list, create, delete, and reply as draft
Enhanced Calendar with working Google Meet links in events
Multiple Google accounts support with OAuth 2.0 token refresh

Use cases of mcp-gsuite-enhanced

Retrieve and summarize unread emails or search for specific messages
Send professional emails or draft replies directly from an AI assistant
Organize emails by creating and applying custom labels automatically
Archive or restore bulk emails for inbox management
Create calendar events with automatic Google Meet links and invite attendees

FAQ from mcp-gsuite-enhanced

What are the prerequisites for using mcp-gsuite-enhanced?

You need Python 3.13+ with uv installed, a Google account with Gmail and Calendar access, and an MCP client (Cursor IDE recommended).

How do I set up authentication?

Create a Google Cloud project, enable Gmail and Calendar APIs, generate OAuth 2.0 Desktop credentials, save them as .gauth.json, then run python auth_setup.py <email> for each account. This stores tokens in .oauth2.<email>.json.

What OAuth scopes does the server request?

It requests openid, userinfo.email, https://mail.google.com/, and https://www.googleapis.com/auth/calendar – no manual configuration needed.

How is this version different from the original mcp-gsuite?

The enhanced version fixes Google Meet integration, makes update_calendar_event fully functional, corrects attendee parsing bugs, and adds setup utilities. The original version has known issues with these features.