Skip to main content
Glama
Sejin-Koo

google-workspace-mcp

by Sejin-Koo

google-workspace-mcp

Servidor MCP que maneja Google Workspace (Sheets / Docs / Slides / Forms) y Google Drive.

El conector oficial "Google Drive" conectado por defecto a Cowork solo admite búsqueda, lectura, creación de archivos y mover a la papelera, y no puede modificar el contenido de archivos existentes. Por eso, incluso para añadir una sola fila a una hoja, no había más opción que recrear todos los datos en un archivo nuevo y descartar el archivo existente. Este servidor llena ese vacío: añade filas a las hojas manteniendo el ID del archivo, modifica el cuerpo de los documentos y agrega diapositivas.

Herramientas disponibles

Herramienta

Qué hace

sheets_values

lectura de valores de celda / append (añadir fila) / update / clear

sheets_manage

crear hojas de cálculo, añadir, eliminar y renombrar pestañas, consultar metadatos, batchUpdate

docs_read

leer documentos como texto (incluidas tablas) o en su estructura original

docs_write

crear documentos, añadir al final, insertar en una posición, buscar y reemplazar, batchUpdate

slides_read

consultar texto y notas del presentador por diapositiva

slides_write

crear presentaciones, añadir diapositivas (rellenar título y cuerpo), eliminar, buscar y reemplazar

forms_tool

crear y consultar formularios, consultar lista de respuestas o una individual, batchUpdate

drive_search

búsqueda por nombre de archivo, búsqueda de texto completo en el contenido, MIME y condiciones de carpeta

drive_file

metadatos, creación, creación de carpetas, reemplazo de contenido (manteniendo el ID), renombrar, mover, copiar, papelera, eliminación definitiva, descarga, export

drive_comments

consultar, escribir, responder, resolver y eliminar comentarios

drive_revisions

consultar historial de versiones, recuperar contenido de versiones anteriores, fijar conservación

drive_permissions

revisar, añadir, modificar y revocar permisos de uso compartido

drive_shared_drives

lista y detalle de unidades compartidas

drive_changes

emitir un token inicial y consultar solo los cambios posteriores a ese punto

Todas las herramientas permiten ajustar el límite de longitud de la respuesta con max_chars; si es 0, no se trunca.

Related MCP server: Google Docs, Drive & Sheets MCP Server

Variables de entorno

Nombre

Descripción

GOOGLE_CLIENT_ID

ID de cliente OAuth

GOOGLE_CLIENT_SECRET

Secreto de cliente OAuth

GOOGLE_REFRESH_TOKEN

token de actualización que incluye el ámbito https://www.googleapis.com/auth/drive

MCP_GATE_KEYS

lista de claves permitidas para la puerta de acceso (separadas por comas). Si está vacía, la puerta queda desactivada

MCP_GATE_MODE

si es enforce, bloquea con 401 las llamadas sin clave

Un solo ámbito drive cubre las API de Sheets, Docs, Slides y Forms, así como toda la API de Drive (la lista oficial de ámbitos de autenticación de cada API incluye auth/drive).

Preparación del proyecto de Google Cloud

Independientemente de los ámbitos, hay que habilitar (Enable) en el proyecto las API que se vayan a usar. Si no se activan, se produce un 403 has not been used in project ... or it is disabled.

  • Google Sheets API / Google Docs API / Google Slides API / Google Forms API

  • Google Drive API

Invocación

https://<배포도메인>/api/mcp?k=<게이트키>

Prueba de humo local

Coloca las 3 credenciales de Google anteriores en scripts/.env.local.json (ignorado por git) y:

npm install
npm test

Crea archivos de prueba en una cuenta real de Google y, al final, los mueve a la papelera.

Related MCP Connectors

Related MCP Servers