Servidor MCP de Google Workspace

Brinda a los agentes de IA acceso completo a Google Workspace (Gmail, Calendar, Drive y más) a través de un único servidor MCP que gestiona el enrutamiento de credenciales para múltiples cuentas, el formato de respuestas para el consumo de IA y orientación contextual.

Construido sobre la CLI oficial de Google Workspace (gws), lo que significa que la cobertura de la API crece a medida que Google lo hace. El servidor utiliza una fábrica basada en manifiestos que convierte YAML declarativo en herramientas MCP totalmente funcionales; añadir una nueva operación de la API de Google es un cambio de configuración, no de código.

Por qué este servidor MCP

Para usuarios: Una instalación le da a su agente de IA acceso real y autenticado a sus cuentas de Google. Busque correos electrónicos, consulte su calendario, gestione archivos de Drive, encadene flujos de trabajo de varios pasos, todo a través de una conversación natural.

Para equipos: El soporte para múltiples cuentas significa que su agente puede trabajar en cuentas personales y de trabajo simultáneamente, con aislamiento de credenciales por cuenta y almacenamiento compatible con XDG.

Para desarrolladores: La arquitectura de fábrica significa que la cobertura se expande rápidamente. La CLI de Workspace de Google ya admite más de 15 servicios y cientos de operaciones de API. El manifiesto selecciona cuáles se exponen, los parches añaden formato específico del dominio y los valores predeterminados se encargan del resto.

Related MCP server: MCP G Suite Integration

Qué está disponible

5 herramientas, más de 32 operaciones en 3 servicios principales:

Cada respuesta incluye orientación sobre próximos pasos: el agente siempre sabe qué puede hacer a continuación.

Cómo funciona

                          ┌─────────────────────────┐
MCP Client ──stdio──▶     │  manifest.yaml           │
                          │  (52 operations declared) │
                          └────────┬────────────────┘
                                   │
                          ┌────────▼────────────────┐
                          │  Factory Generator       │
                          │  schemas + handlers      │
                          └────────┬────────────────┘
                                   │
                    ┌──────────────┼──────────────┐
                    ▼              ▼              ▼
              ┌──────────┐  ┌──────────┐  ┌──────────┐
              │  Gmail   │  │ Calendar │  │  Drive   │
              │  Patch   │  │  Patch   │  │  Patch   │
              └────┬─────┘  └────┬─────┘  └────┬─────┘
                   │             │             │
                   └──────┬──────┘──────┬──────┘
                          ▼             ▼
                    Account Router ──▶ gws CLI ──▶ Google APIs

La fábrica lee un manifiesto YAML y genera esquemas de herramientas MCP y controladores de solicitudes al inicio. Los parches añaden un comportamiento específico del dominio donde sea necesario: hidratación de búsqueda de Gmail, formato de calendario, detección de tipo de archivo de Drive. Las operaciones sin parches obtienen valores predeterminados razonables automáticamente.

El motor subyacente es @googleworkspace/cli de Google, un binario de Rust que envuelve toda la superficie de la API de Google Workspace. El servidor MCP selecciona qué operaciones exponer y da forma a las respuestas para el consumo de la IA.

Instalación

Paquete MCPB (Claude Desktop y otros clientes MCP)

Descargue el paquete .mcpb para su plataforma desde la versión más reciente:

En Claude Desktop, arrastre el archivo .mcpb a la aplicación; le solicitará sus credenciales de OAuth de Google y estará listo para comenzar. Otros clientes MCP que admiten extensiones .mcpb pueden instalarlo de la misma manera. El paquete incluye todo: el servidor, el binario gws y todas las dependencias.

Claude Code / npm

npm install @aaronsb/google-workspace-mcp

O ejecute directamente:

npx @aaronsb/google-workspace-mcp

Requisitos previos

1. Node.js 18+

2. Credenciales de OAuth de Google Cloud: créelas en console.cloud.google.com/apis/credentials:

   • Cree un ID de cliente de OAuth 2.0 (aplicación de escritorio)

   • Habilite las API que desee (Gmail, Calendar, Drive, Sheets, etc.)

3. Establezca las variables de entorno:

export GOOGLE_CLIENT_ID="your-client-id"
export GOOGLE_CLIENT_SECRET="your-client-secret"

Configuración del cliente MCP

Claude Desktop

Añada a claude_desktop_config.json:

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["@aaronsb/google-workspace-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Code

Añada a .mcp.json:

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["@aaronsb/google-workspace-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Uso

Añada una cuenta (abre el navegador para OAuth):

manage_accounts { "operation": "authenticate" }

Luego use cualquier herramienta con su correo electrónico de cuenta:

manage_email    { "operation": "triage", "email": "you@gmail.com" }
manage_calendar { "operation": "agenda", "email": "you@gmail.com" }
manage_drive    { "operation": "search", "email": "you@gmail.com", "query": "quarterly report" }

Flujos de trabajo de varios pasos

Encadene operaciones con referencias de resultados: la salida de un paso alimenta al siguiente:

{
  "operations": [
    { "tool": "manage_email", "args": { "operation": "search", "email": "you@gmail.com", "query": "from:boss subject:review" }},
    { "tool": "manage_email", "args": { "operation": "read", "email": "you@gmail.com", "messageId": "$0.messageId" }}
  ]
}

Ampliación de la cobertura

El servidor descubre operaciones desde la CLI de gws, que ya admite más de 15 servicios de Google (Sheets, Docs, Tasks, People, Chat y más). Añadir cobertura es una edición del manifiesto:

make manifest-discover   # Find all 287+ available operations
make manifest-lint       # Validate the curated manifest
make test                # Verify everything works

Las nuevas operaciones obtienen el formato predeterminado automáticamente. Añada un parche solo cuando necesite una presentación específica del dominio.

Almacenamiento de datos

Sigue la especificación de directorio base XDG:

Las credenciales son archivos por cuenta con tokens OAuth estándar. No se almacenan secretos en el directorio del proyecto.

Licencia

MIT