Google Workspace MCP Server

MCP (Model Context Protocol) server for comprehensive Google Workspace integration with Claude Code and Claude Desktop.

Credits: This project is based on google-drive-mcp by Piotr Agier. Extended to support the full Google Workspace suite.

Español | English

Features

Full integration with Google Workspace APIs:

Total: 114 MCP tools

Quick Start

1. Install dependencies

npm install

2. Configure OAuth credentials

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the APIs you need:
   • Google Drive API (required)
   • Google Docs API (required)
   • Google Sheets API (required)
   • Google Slides API (required)
   • Google Calendar API (optional)
   • Gmail API (optional)
   • Google Meet API (optional)
   • Google Tasks API (optional)
   • People API (optional, for Contacts)
4. Create OAuth 2.0 credentials (Desktop app)
5. Download the JSON file and save as gcp-oauth.keys.json in the project root

3. Authenticate

# Basic (Drive, Docs, Sheets, Slides)
npm run auth

# With Calendar
GOOGLE_WORKSPACE_CALENDAR=true npm run auth

# With Gmail
GOOGLE_WORKSPACE_GMAIL=true npm run auth

# With Meet
GOOGLE_WORKSPACE_MEET=true npm run auth

# With Tasks
GOOGLE_WORKSPACE_TASKS=true npm run auth

# With Contacts
GOOGLE_WORKSPACE_CONTACTS=true npm run auth

# All services
GOOGLE_WORKSPACE_CALENDAR=true GOOGLE_WORKSPACE_GMAIL=true GOOGLE_WORKSPACE_MEET=true GOOGLE_WORKSPACE_TASKS=true GOOGLE_WORKSPACE_CONTACTS=true npm run auth

4. Configure Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/path/to/google-workspace-mcp/dist/index.js"],
      "env": {
        "GOOGLE_WORKSPACE_CALENDAR": "true",
        "GOOGLE_WORKSPACE_GMAIL": "true",
        "GOOGLE_WORKSPACE_MEET": "true",
        "GOOGLE_WORKSPACE_TASKS": "true",
        "GOOGLE_WORKSPACE_CONTACTS": "true"
      }
    }
  }
}

5. Configure Claude Code

Add to your global Claude Code config (~/.claude.json):

{
  "mcpServers": {
    "google-workspace": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/google-workspace-mcp/dist/index.js"],
      "env": {
        "GOOGLE_WORKSPACE_CALENDAR": "true",
        "GOOGLE_WORKSPACE_GMAIL": "true",
        "GOOGLE_WORKSPACE_MEET": "true",
        "GOOGLE_WORKSPACE_TASKS": "true",
        "GOOGLE_WORKSPACE_CONTACTS": "true"
      }
    }
  }
}

Tools Reference

Google Drive (14 tools)

Files

Folders

Drive Permissions (5 tools)

Google Docs (4 tools)

Google Sheets (8 tools)

Google Slides (7 tools)

Google Calendar (24 tools)

Enable with GOOGLE_WORKSPACE_CALENDAR=true

Events

Calendars

Calendar Management

Gmail (24 tools)

Enable with GOOGLE_WORKSPACE_GMAIL=true

Messages

Threads

Drafts

Labels

Other

Google Meet (18 tools)

Enable with GOOGLE_WORKSPACE_MEET=true

Spaces

Members

Conference Records

Participants

Recordings

Transcripts

Google Tasks (12 tools)

Enable with GOOGLE_WORKSPACE_TASKS=true

Task Lists

Tasks

Google Contacts (10 tools)

Enable with GOOGLE_WORKSPACE_CONTACTS=true

Contacts

Contact Groups

Service Configuration

Services can be enabled/disabled via environment variables:

OAuth Scopes

The server requests only the scopes needed for enabled services:

Project Structure

src/
├── index.ts              # Entry point
├── server.ts             # MCP server setup
├── auth/                 # OAuth2 authentication
│   ├── index.ts
│   ├── client.ts
│   ├── server.ts
│   └── tokenManager.ts
├── config/
│   └── services.ts       # Service configuration
├── services/             # API wrappers
│   ├── drive.ts
│   ├── docs.ts
│   ├── sheets.ts
│   ├── slides.ts
│   ├── calendar.ts
│   ├── gmail.ts
│   ├── meet.ts
│   ├── tasks.ts
│   └── contacts.ts
├── tools/                # MCP tool definitions
│   ├── files.ts
│   ├── folders.ts
│   ├── docs.ts
│   ├── sheets.ts
│   ├── slides.ts
│   ├── calendar.ts
│   ├── gmail.ts
│   ├── meet.ts
│   ├── tasks.ts
│   ├── contacts.ts
│   └── permissions.ts
└── utils/
    ├── paths.ts
    └── errors.ts

Development

# Build
npm run build

# Run authentication
npm run auth

# Run tests
node test-gmail.mjs          # Gmail tests
node test-meet.mjs           # Meet tests
node test-new-features.mjs   # Tasks, Contacts, Permissions tests

Requirements

• Node.js 18+
• Google Cloud project with OAuth credentials
• Google Workspace account (some Meet features require paid Workspace)

License

MIT

Credits

• Original project: google-drive-mcp by Piotr Agier
• Extended by: DonMrMango

Español

Google Workspace MCP Server

Servidor MCP (Model Context Protocol) para integración completa de Google Workspace con Claude Code y Claude Desktop.

Créditos: Este proyecto está basado en google-drive-mcp de Piotr Agier. Extendido para soportar toda la suite de Google Workspace.

Características

Integración completa con las APIs de Google Workspace:

Total: 114 herramientas MCP

Inicio Rápido

1. Instalar dependencias

npm install

2. Configurar credenciales OAuth

1. Ir a Google Cloud Console
2. Crear un nuevo proyecto o seleccionar uno existente
3. Habilitar las APIs que necesites:
   • Google Drive API (requerida)
   • Google Docs API (requerida)
   • Google Sheets API (requerida)
   • Google Slides API (requerida)
   • Google Calendar API (opcional)
   • Gmail API (opcional)
   • Google Meet API (opcional)
   • Google Tasks API (opcional)
   • People API (opcional, para Contacts)
4. Crear credenciales OAuth 2.0 (aplicación de escritorio)
5. Descargar el archivo JSON y guardarlo como gcp-oauth.keys.json en la raíz del proyecto

3. Autenticar

# Básico (Drive, Docs, Sheets, Slides)
npm run auth

# Con Calendar
GOOGLE_WORKSPACE_CALENDAR=true npm run auth

# Con Gmail
GOOGLE_WORKSPACE_GMAIL=true npm run auth

# Con Meet
GOOGLE_WORKSPACE_MEET=true npm run auth

# Con Tasks
GOOGLE_WORKSPACE_TASKS=true npm run auth

# Con Contacts
GOOGLE_WORKSPACE_CONTACTS=true npm run auth

# Todos los servicios
GOOGLE_WORKSPACE_CALENDAR=true GOOGLE_WORKSPACE_GMAIL=true GOOGLE_WORKSPACE_MEET=true GOOGLE_WORKSPACE_TASKS=true GOOGLE_WORKSPACE_CONTACTS=true npm run auth

4. Configurar Claude Desktop

Agregar a la configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/ruta/a/google-workspace-mcp/dist/index.js"],
      "env": {
        "GOOGLE_WORKSPACE_CALENDAR": "true",
        "GOOGLE_WORKSPACE_GMAIL": "true",
        "GOOGLE_WORKSPACE_MEET": "true",
        "GOOGLE_WORKSPACE_TASKS": "true",
        "GOOGLE_WORKSPACE_CONTACTS": "true"
      }
    }
  }
}

5. Configurar Claude Code

Agregar a la configuración global de Claude Code (~/.claude.json):

{
  "mcpServers": {
    "google-workspace": {
      "type": "stdio",
      "command": "node",
      "args": ["/ruta/a/google-workspace-mcp/dist/index.js"],
      "env": {
        "GOOGLE_WORKSPACE_CALENDAR": "true",
        "GOOGLE_WORKSPACE_GMAIL": "true",
        "GOOGLE_WORKSPACE_MEET": "true",
        "GOOGLE_WORKSPACE_TASKS": "true",
        "GOOGLE_WORKSPACE_CONTACTS": "true"
      }
    }
  }
}

Configuración de Servicios

Los servicios se pueden habilitar/deshabilitar mediante variables de entorno:

Requisitos

• Node.js 18+
• Proyecto de Google Cloud con credenciales OAuth
• Cuenta de Google Workspace (algunas funciones de Meet requieren Workspace de pago)

Licencia

MIT

Créditos

• Proyecto original: google-drive-mcp por Piotr Agier
• Extendido por: DonMrMango