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.

🚀 Quick Start

Prerequisite: Bun installed.

Clone & Install

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

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)

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

Category	Available Tools
📧 Gmail	`get_account_info`, `send_email`
📅 Calendar	`list_calendar_events`, `create_calendar_event`
📁 Drive	`list_drive_folders`, `search_drive`
📝 Docs	`create_document`, `get_document`, `append_to_document`
📊 Sheets	`create_spreadsheet`, `read_spreadsheet`, `update_spreadsheet`, `append_to_spreadsheet`
🖼️ Slides	`create_presentation`, `get_presentation`, `add_slide`

🛠️ 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

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