google-workspace-mcp

MCP multi-cuenta y eficiente en tokens para Gmail + Calendar + Drive + Docs + Sheets. Creado porque el conector oficial de Claude admite una sola cuenta y devuelve los cuerpos completos de mensajes/archivos por defecto.

Por qué existe esto

• Multi-cuenta: OAuth de múltiples buzones (trabajo + personal + cofundador). Cada herramienta recibe un correo account; los alias se gestionan mediante identidades Send-As.

• Eficiente en tokens: Búsqueda/listado devuelve formas compactas ({id, from, subject, snippet, ...} para correo, {id, name, mime, modified, size, ...} para Drive). Los cuerpos y el contenido de archivos son opcionales.

• Respaldado por llavero: Los tokens de actualización viven en el almacén de credenciales del sistema operativo — Keychain en macOS, Credential Manager en Windows, Secret Service en Linux — no en archivos de texto plano. Sin tokens en el vault, sin tokens en ningún repositorio.

• macOS, Windows y Linux: un instalador por plataforma, el mismo conector.

Related MCP server: google-workspace-mcp

Herramientas (v2, 63 herramientas)

Gestión de cuentas (3)

• gws_account_add — flujo OAuth en el navegador, añade un nuevo buzón autorizado

• gws_account_list — lista cuentas autorizadas + predeterminada

• gws_account_remove — elimina la credencial local (no revoca en el lado de Google)

Gmail (12)

• gmail_search — búsqueda con operadores de Gmail. Respuesta compacta.

• gmail_read — lee un mensaje o hilo completo. Cuerpos opcionales.

• gmail_send — envía correo, from_alias opcional para identidades Send-As

• gmail_draft — crea un borrador

• gmail_reply — responde (conserva hilo + cabeceras), reply_all opcional

• gmail_labels_list — lista todas las etiquetas

• gmail_label_apply — añadir/eliminar etiquetas en lote

• gmail_archive — archivar en lote (quitar de INBOX)

• gmail_trash — mover a la papelera en lote

• gmail_sendas_list — lista identidades Send-As en este buzón

• gmail_attachments_list — lista los adjuntos de un mensaje (nombre de archivo, tipo MIME, tamaño)

• gmail_attachment_save — descarga un adjunto a un archivo local, se devuelve la ruta para lectura directa

Calendar (7)

• cal_list_calendars — lista todos los calendarios

• cal_list_events — lista próximos eventos (compacto por defecto, verbose=True para completo)

• cal_create_event — crea evento, enlace opcional de Google Meet

• cal_update_event — actualiza campos parcialmente

• cal_delete_event — elimina

• cal_freebusy — comprueba ventanas ocupadas para programar

• cal_respond — aceptar/rechazar/tentativo

Drive (18)

• drive_search — texto libre o sintaxis q de Drive. Respuesta solo de metadatos.

• drive_read_file — metadatos por defecto; include_content=True para el cuerpo

• drive_list_folder — hijos directos de una carpeta ('root' para Mi Drive)

• drive_create_folder — crea una carpeta bajo un padre opcional

• drive_upload — sube un archivo local, convert_to_google opcional

• drive_move — cambia la carpeta padre

• drive_rename — renombra un archivo o carpeta

• drive_share — concede acceso de lector/comentarista/escritor/etc. por correo

• drive_trash — borrado suave (recuperable)

• drive_untrash — restaura desde la papelera

• drive_permission_list — lista a todos los que tienen acceso a un archivo

• drive_permission_update — cambia el rol de un beneficiario

• drive_permission_delete — revoca un permiso

• drive_shared_drives_list — lista los drives compartidos a los que accede esta cuenta

• drive_comments_list — lista comentarios en cualquier archivo de Drive (Doc/Sheet/Slide/subido)

• drive_comment_add — añade un comentario, ancla opcional

• drive_comment_reply — responde a un comentario

• drive_comment_resolve — marca un comentario como resuelto

Docs (9)

• docs_create — nuevo Doc, cuerpo inicial y carpeta padre opcionales

• docs_read — texto plano por defecto; structured=True para el árbol completo de la API de Docs

• docs_append — añade texto al final del cuerpo

• docs_insert_at — inserta texto en un índice específico

• docs_replace_text — buscar y reemplazar, devuelve el número de reemplazos

• docs_export — exporta a markdown / pdf / docx / rtf / texto plano

• docs_suggestions_list — lista sugerencias pendientes de cambios controlados

• docs_suggestions_accept_all — acepta todas las sugerencias (reescribe el Doc)

• docs_suggestions_reject_all — rechaza todas las sugerencias (reescribe el Doc)

Sheets (14)

• sheets_create — nuevo libro de trabajo, carpeta padre opcional

• sheets_list_sheets — lista pestañas con dimensiones de filas/columnas

• sheets_add_sheet — añade una nueva pestaña a un libro existente

• sheets_read_range — lee un rango A1. Opciones FORMULA / UNFORMATTED_VALUE.

• sheets_write_range — sobrescribe un rango. USER_ENTERED analiza fórmulas.

• sheets_append — añade filas debajo de los datos existentes

• sheets_clear_range — borra valores (se conserva el formato)

• sheets_batch_read — lectura de múltiples rangos en una sola llamada a la API

• sheets_batch_write — escritura de múltiples rangos en una sola llamada a la API

• sheets_named_ranges_list — lista rangos con nombre en un libro

• sheets_named_range_add — crea un rango con nombre

• sheets_named_range_delete — elimina un rango con nombre

• sheets_conditional_format_add — añade una regla de formato condicional

• sheets_data_validation_add — establece validación de lista desplegable / número / correo / URL

Instalación

Ruta más rápida: un solo script, sin configuración manual.

macOS y Linux:

git clone https://github.com/adelaidasofia/google-workspace-mcp.git
bash google-workspace-mcp/install.sh

Windows (PowerShell):

git clone https://github.com/adelaidasofia/google-workspace-mcp.git
powershell -ExecutionPolicy Bypass -File .\google-workspace-mcp\install.ps1

El instalador crea un venv aislado, instala dependencias, toma tu cliente OAuth de Google (ya sea interactivamente o mediante GWS_CLIENT_ID / GWS_CLIENT_SECRET en el entorno) y registra el servidor con Claude Code. Es seguro volver a ejecutarlo. Aún necesitas un cliente OAuth de Google primero: consulta SETUP.md para la configuración única de GCP de ~45 min. Luego ejecuta gws_account_add desde Claude Code para autorizar tu primer buzón.

Ambos necesitan Python 3.10 o superior y encontrarán uno que ya tengas.

• macOS / Linux prueban python3 primero, luego python3.14 hasta python3.10, de modo que un Python de Homebrew aún cuenta cuando python3 resuelve al sistema antiguo de macOS.

• Windows prueba py -3 (el lanzador de Python) primero, luego python, python3 y los nombres versionados. Cada candidato debe ejecutarse e informar su propia versión antes de contar, lo que evita que se elija el marcador de posición de Microsoft Store en %LOCALAPPDATA%\Microsoft\WindowsApps: es un python.exe real en PATH que solo abre la Store.

Si el tuyo está en un lugar que ninguna búsqueda adivinaría (pyenv, conda, un prefijo privado), nómbralo:

GWS_PYTHON=/full/path/to/python3 bash google-workspace-mcp/install.sh

$env:GWS_PYTHON = 'C:\full\path\to\python.exe'
powershell -ExecutionPolicy Bypass -File .\google-workspace-mcp\install.ps1

-ExecutionPolicy Bypass está en el comando a propósito. Windows bloquea los scripts descargados por defecto; esto aplica la excepción a esta única ejecución sin cambiar la política de la máquina.

Ejecútalo desde PowerShell, no desde Git Bash. install.sh detecta Git Bash / MSYS y se detiene allí con una indicación a install.ps1, en lugar de registrar una ruta de venv POSIX que un Claude Code nativo no puede lanzar. WSL es Linux real y sigue usando install.sh.

Zona horaria. El conector lee la zona IANA de la máquina para que "3pm" en una llamada cal_* signifique 3pm donde estés. Windows nombra sus zonas a su manera (SA Western Standard Time), por lo que esto pasa por tzlocal, que el instalador incluye. Establece GWS_TIME_ZONE=America/Bogota para anular.

Abre Claude Code, pega:

/plugin marketplace add adelaidasofia/google-workspace-mcp
/plugin install google-workspace-mcp@google-workspace-mcp

Aún necesitas completar la configuración única de GCP en SETUP.md (~45 min para v1, ~5 min incremental para v2 Drive/Docs/Sheets) para que el servidor tenga un client_secret.json contra el que hacer OAuth. Ejecuta gws_account_add desde Claude Code para autorizar tu primer buzón.

En Windows, ejecuta install.ps1 después. El .mcp.json del plugin lanza el servidor con python3, y un manifiesto de plugin no tiene forma de decir "excepto en Windows, usa esto en su lugar". En Windows python3 está ausente o es el marcador de posición de Microsoft Store, por lo que el conector se registra y nunca se inicia. install.ps1 lo vuelve a registrar con una ruta absoluta de intérprete, que es inequívoca en todas las plataformas.

Consulta SETUP.md para la configuración única de GCP (~45 min para v1, ~5 min incremental para habilitar Drive/Docs/Sheets en v2).

Después de la configuración:

pip3 install --break-system-packages -r requirements.txt

Registrar con Claude Code

Añade al .mcp.json de tu proyecto (o ~/.claude.json para acceso global):

"google-workspace": {
  "type": "stdio",
  "command": "python3",
  "args": ["/path/to/google-workspace-mcp/server.py"]
}

En Windows, da la ruta completa a un intérprete real en lugar de un nombre simple: python3 allí suele ser el marcador de posición de Microsoft Store, que se resuelve bien y nunca ejecuta Python:

"google-workspace": {
  "type": "stdio",
  "command": "C:\\Users\\you\\google-workspace-mcp\\.venv\\Scripts\\python.exe",
  "args": ["C:\\Users\\you\\google-workspace-mcp\\server.py"]
}

Actualización de v1 → v2

v2 añade ámbitos de Drive + Docs + Sheets. Cada cuenta autorizada debe volver a hacer OAuth una vez para que Google conceda los nuevos ámbitos. Consulta el paso 6b de SETUP.md.

Hoja de ruta

• v3: filtros de Gmail, respuesta de vacaciones, notificaciones push (Gmail Watch), ACL/delegación de Calendar, Slides, Forms, Tasks

• v4: solicitudes por lotes entre servicios, revisiones de Drive

MCPs relacionados

Mismo autor, mismo patrón de arquitectura (FastMCP, borrador+confirmación en escrituras cuando corresponda, autoexportación de vault, MIT):

• slack-mcp — Slack multi-espacio de trabajo

• imessage-mcp — iMessage de macOS

• whatsapp-mcp — WhatsApp vía whatsmeow

• apollo-mcp — CRM de Apollo.io + secuencias

• substack-mcp — escritura + analíticas de Substack

• luma-mcp — eventos de lu.ma

• parse-mcp — enrutador de markitdown / Docling / LlamaParse

• rescuetime-mcp — datos de productividad de RescueTime

• graph-query-mcp — consultas al grafo de conocimiento del vault

• graph-autotagger-mcp — sugerencias de wikilinks desde el grafo

• investor-relations-mcp — seguimiento de pipeline de ronda semilla

• vault-sync-mcp — sincronización bidireccional del vault

Telemetría

Este plugin envía una única señal anónima de instalación a myceliumai.co la primera vez que se carga en una sesión de Claude Code en una máquina determinada.

Qué se envía:

• Nombre del plugin (p. ej. slack-mcp)

• Versión del plugin (p. ej. 0.1.0)

Qué NO se envía:

• Sin identificadores de usuario, nombres, correos, tokens ni claves de API

• Sin rutas de archivo, contenido de mensajes ni nada de tu trabajo

• No se almacena ninguna dirección IP después del procesamiento de deduplicación

Por qué: Ayuda al mantenedor a saber qué plugins instala realmente la gente, para que la atención se centre en los que se usan.

Exclusión voluntaria: Establezca la variable de entorno MYCELIUM_NO_PING=1 antes de lanzar Claude Code. El hook omitirá por completo la llamada de red. Las instalaciones que ya han hecho ping dejan un centinela en ~/.mycelium/onboarded-<plugin> — elimínelo si desea restablecer el estado.

Licencia

MIT

Creado por Mycelium AI. Instalación completa o versión de equipo en diazroa.com.