gg-workspace-mcp 🐶🚀

The fastest, most lightweight Google Workspace MCP Server powered by Bun. ⚡️

Manage your entire Google Workspace (Gmail, Calendar, Drive, Docs, Sheets, Slides) directly through natural language with AI assistants like Claude, Cursor, and more.

📚 Documentation

• Installation & User Guide - Full setup instructions, authentication, and troubleshooting.

• Client Configuration - Ready-to-use configs for Claude, Cursor, VS Code, JetBrains, and 20+ other clients.

🌟 Features

• ⚡ Blazing Fast: Built with Bun for near-instant execution and low overhead.

• 🔐 1-Click Auth: Built-in Auth Portal for effortless Google Account connection.

• 🛠️ Comprehensive: 20+ tools covering the essential Google Workspace ecosystem.

• 🛡️ Secure: Pure TypeScript implementation with official Google SDKs.

Related MCP server: google-workspace-mcp-with-script

🚀 Quick Start

Prerequisite: Bun installed.

1. Clone & Install

   git clone https://github.com/tannht/gg-workspace-mcp.git
   cd gg-workspace-mcp
   bun install

2. Set Credentials

   cp .env.example .env
   # Edit .env and update GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET

   (See GUIDE.md for how to get these credentials)

3. Run Server

   bun run src/index.ts

🤖 MCP Client Integration

We support 25+ clients including Claude Desktop, Cursor, VS Code, JetBrains, and more.

👉 Click here to view the full Client Configuration Guide (MCP_CLIENTS.md)

Quick Example (Claude Desktop):

Using Bun (recommended, faster):

{
  "mcpServers": {
    "gg-workspace-mcp": {
      "command": "bunx",
      "args": ["gg-workspace-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "...",
        "GOOGLE_CLIENT_SECRET": "..."
      }
    }
  }
}

Using npm/npx:

{
  "mcpServers": {
    "gg-workspace-mcp": {
      "command": "npx",
      "args": ["gg-workspace-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "...",
        "GOOGLE_CLIENT_SECRET": "..."
      }
    }
  }
}

🧰 Available Tools

🛠️ Local Development

# Run locally
bun run src/index.ts

# Run tests (if added)
bun test

For detailed troubleshooting and development setup, see GUIDE.md.

📄 License

MIT © Hoang Tan

Built with 🦴 by PubPug AI. Gâu gâu! 🐶🚀