🌐 Antigravity Google Workspace MCP Server

Unified, High-Speed Model Context Protocol (MCP) Server for the Entire Google Workspace Ecosystem

📑 Table of Contents

• ✨ Features

• 🏛️ System Architecture

• 🛠️ Tool Catalog (22 Operations)

• 🚀 Quickstart & Setup

  • 1. Prerequisites

  • 2. Google Cloud OAuth Setup

  • 3. Installation & Authentication

• ⚙️ Client Configurations

  • Antigravity CLI

  • Claude Desktop

  • Cursor / Windsurf / Other MCP Hosts

• 🔒 Security & Token Hygiene

• 📄 License

Related MCP server: google-services-mcp

✨ Features

• ⚡ All-In-One Unified Server: A single lightweight Python MCP server providing access to 7 core Google Workspace services without juggling multiple server instances.

• 📬 Full Gmail Operations: List messages, fetch full thread content, generate drafts, send emails, and trash spam.

• 📅 Bi-directional Calendar Sync: List upcoming events, create new schedules with attendee invites, and cancel events.

• 📝 Google Tasks Integration: Manage task lists, create tactical tasks with due dates, and mark completions.

• 📂 Google Drive & Docs Intelligence: Query files, read docs, create new Google Docs, and append content dynamically.

• 📊 Spreadsheets Engine: Read tabular data, append rows, and update spreadsheet cell ranges.

• 📇 Google Contacts Management: Search contact lists and create new address book entries.

• 🔐 Zero-Leak Architecture: Local OAuth token caching with automated token refresh and strict gitignore isolation.

🏛️ System Architecture

┌──────────────────────────────────────────────────────────────────┐
│                      AI CLIENT / HOST AGENT                      │
│            (Antigravity CLI / Claude Desktop / Cursor)            │
└─────────────────────────────────┬────────────────────────────────┘
                                  │ JSON-RPC (stdio)
                                  ▼
┌──────────────────────────────────────────────────────────────────┐
│             ANTIGRAVITY GOOGLE WORKSPACE MCP SERVER              │
│                       (server.py / FastMCP)                      │
├──────────────────────────────────────────────────────────────────┤
│ 🔐 OAuth Token Engine (Auto-Refresh & Local Token Storage)       │
├──────────────────────────────────────────────────────────────────┤
│ 📅 Calendar  │ 📬 Gmail     │ 📂 Drive & Docs │ 📇 Contacts       │
│ 📝 Tasks     │ 📊 Sheets    │ 🔒 Auth Guard   │ ⚡ Error Filter   │
└─────────────────────────────────┬────────────────────────────────┘
                                  │ HTTPS (Google APIs v1/v3/v4)
                                  ▼
┌──────────────────────────────────────────────────────────────────┐
│                 GOOGLE WORKSPACE CLOUD PLATFORM                  │
│       [ Gmail · Calendar · Tasks · Drive · Docs · Sheets ]       │
└──────────────────────────────────────────────────────────────────┘

🛠️ Tool Catalog (22 Operations)

🚀 Quickstart & Setup

1. Prerequisites

• Python 3.10+ installed

• A Google Account with Google Cloud Platform access

2. Google Cloud OAuth Setup

1. Go to the Google Cloud Console.

2. Create a new project (e.g. Antigravity-Workspace).

3. Enable the following 7 APIs under APIs & Services > Library:

   • Google Calendar API

   • Tasks API

   • Gmail API

   • Google Drive API

   • Google Docs API

   • Google Sheets API

   • People API (Google Contacts)

4. Configure the OAuth Consent Screen:

   • User Type: External (or Internal for Workspace organizations).

   • Add your Google account as a Test User.

5. Create OAuth Credentials:

   • Navigate to Credentials > Create Credentials > OAuth Client ID.

   • Application Type: Desktop App.

   • Name: Antigravity-Workspace-Client.

6. Download the generated client configuration JSON and save it as credentials.json in the root of this project:

   cp ~/Downloads/client_secret_*.json ./credentials.json

3. Installation & Authentication

# 1. Clone the repository
git clone https://github.com/your-username/antigravity-google-workspace.git
cd antigravity-google-workspace

# 2. Install dependencies
pip install -r requirements.txt

# 3. Authenticate with Google
python auth_setup.py

A local browser window will open at http://localhost:8088. Sign in, grant permissions, and token.json will be saved locally.

⚙️ Client Configurations

Antigravity CLI

Add to your mcp_config.json or Antigravity MCP settings:

{
  "mcpServers": {
    "google-workspace": {
      "command": "python",
      "args": [
        "C:\\Users\\<USER>\\.gemini\\google-workspace\\server.py"
      ]
    }
  }
}

Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "google-workspace": {
      "command": "python",
      "args": [
        "/path/to/antigravity-google-workspace/server.py"
      ]
    }
  }
}

🔒 Security & Token Hygiene

• Zero Hardcoded Secrets: Client secrets and live tokens are strictly isolated in credentials.json and token.json.

• Git Ignored: .gitignore strictly blocks all tokens, secrets, .env, and session states from ever entering source control.

• Local Token Refresh: Expired tokens are refreshed automatically on the fly without storing plaintext credentials in memory.

🧠 Official Companion Skill & Autonomous Governance

This MCP server is natively governed and orchestrated by the gsuite skill from the antigravity-custom-skills suite.

• 📖 Skill Specification: gsuite/SKILL.md

• 🌐 Master Skillpack Suite: Antigravity Custom Skills

📄 License

This project is open-source and licensed under the MIT License.