gws-mcp-server

Servidor MCP que expone las operaciones de la CLI de Google Workspace (gws) como herramientas del Protocolo de Contexto de Modelo (MCP).

¿Por qué?

La CLI gws tenía un servidor MCP integrado que fue eliminado en la v0.8.0 porque exponía entre 200 y 400 herramientas, lo que causaba un exceso de carga en la ventana de contexto de los clientes MCP. Este servidor adopta un enfoque seleccionado: tú eliges qué servicios de Google exponer, y solo se registran como herramientas un conjunto enfocado de operaciones de alto valor y alcance limitado.

Requisitos previos

• Node.js 18+

• CLI gws instalada y autenticada (npm install -g @googleworkspace/cli && gws auth login)

Inicio rápido

# Install
npm install -g gws-mcp-server

# Or run from source
git clone https://github.com/conorbronsdon/gws-mcp-server.git
cd gws-mcp-server
npm install && npm run build

Configuración

Claude Code (.mcp.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar,docs,gmail"
      ]
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar"
      ]
    }
  }
}

Opciones

Servicios y herramientas disponibles

drive (8 herramientas)

• drive_files_list — Buscar y listar archivos

• drive_files_get — Obtener metadatos de archivos

• drive_files_create — Crear archivos (con carga opcional)

• drive_files_copy — Copiar archivos (útil para conversión de formato)

• drive_files_update — Actualizar metadatos/contenido de archivos

• drive_files_delete — Eliminar archivos

• drive_files_export — Exportar archivos de Google Workspace (Doc, Sheet, Slide) a otros formatos

• drive_permissions_create — Compartir archivos

sheets (4 herramientas)

• sheets_get — Obtener metadatos de hojas de cálculo

• sheets_values_get — Leer valores de celdas

• sheets_values_update — Escribir valores de celdas

• sheets_values_append — Añadir filas

calendar (5 herramientas)

• calendar_events_list — Listar eventos

• calendar_events_get — Obtener detalles de eventos

• calendar_events_insert — Crear eventos

• calendar_events_update — Actualizar eventos

• calendar_events_delete — Eliminar eventos

docs (3 herramientas)

• docs_get — Obtener contenido de documentos

• docs_create — Crear documentos

• docs_batchUpdate — Aplicar actualizaciones a documentos

gmail (4 herramientas)

• gmail_messages_list — Buscar mensajes

• gmail_messages_get — Leer un mensaje

• gmail_threads_list — Buscar hilos

• gmail_threads_get — Leer un hilo completo

Total: 24 herramientas (frente a las 200-400 de la implementación anterior)

Añadir nuevas herramientas

Edita src/services.ts para añadir definiciones de herramientas. Cada herramienta se asigna directamente a un comando de la CLI gws:

{
  name: "drive_files_list",           // MCP tool name
  description: "List files in Drive", // Shown to AI
  command: ["drive", "files", "list"],// gws CLI args
  params: [                           // Maps to --params JSON
    { name: "q", description: "Search query", type: "string", required: false },
  ],
  bodyParams: [                       // Maps to --json body
    { name: "name", description: "File name", type: "string", required: true },
  ],
}

Arquitectura

MCP Client (Claude) ←→ stdio ←→ gws-mcp-server ←→ gws CLI ←→ Google APIs

El servidor es un envoltorio ligero: traduce las llamadas a herramientas MCP en invocaciones de la CLI gws, pasa --params y --json según corresponda, y devuelve la salida JSON.

Aviso legal

Todas las opiniones, puntos de vista y declaraciones expresadas en esta cuenta son exclusivamente mías y se realizan a título personal. No reflejan, y no deben interpretarse como que reflejan, los puntos de vista, posiciones o políticas de Modular. Esta cuenta no está afiliada, autorizada ni respaldada por Modular de ninguna manera.

Licencia

MIT