google-suite-mcp

Tienes una IA que puede pensar. Ahora dale manos.

Un servidor MCP de código abierto para Google Workspace que otorga a Claude Desktop, Cursor, Windsurf, Zed, VS Code (GitHub Copilot), Gemini CLI y cualquier otro cliente del Protocolo de Contexto de Modelo (MCP) control total de lectura/escritura sobre Google Sheets, Docs, Drive y Apps Script. 82 herramientas. Un solo servidor. Licencia MIT.

google-suite-mcp es el primer Operador de Workspace: el único MCP que trata a Google Workspace como un entorno de ejecución que una IA puede operar. Crea paneles, despliega Apps Scripts y formatea documentos en una sola llamada, en lugar de exponer Workspace como una superficie de solo lectura para muestrear.

Una configuración de OAuth de 10 minutos es todo el costo de entrada. Después de eso, una sola instrucción en lenguaje natural puede construir un panel de KPI de múltiples celdas (sheets_build_dashboard), convertir un esquema en una hoja completamente formateada (sheets_build_sheet) o publicar un Google Apps Script como una aplicación web en vivo (script_deploy). Esas son tres primitivas compuestas que ningún otro MCP de Google que hayamos visto ofrece. Cada herramienta está probada: 30 de 30 pruebas de extremo a extremo pasan contra APIs de Google reales, no simulaciones. Si una herramienta aparece aquí, ha sido ejecutada contra los endpoints de producción de Google y ha devuelto el resultado esperado.

MCP es un protocolo, no una función de Claude. Cualquier cliente que hable el Protocolo de Contexto de Modelo puede usar este servidor, independientemente del modelo que haya detrás.

¿No sabes por dónde empezar? Pega la URL de este repositorio en Claude Code, Claude Desktop, Cursor o ChatGPT y pídele que te ayude a instalarlo. SETUP.md está escrito para que tu IA pueda guiarte en cada paso, abrir los enlaces de Google Cloud por ti y verificar que todo funcione al final.

Lo que puedes hacer en 60 segundos de instrucciones

Estos son resultados reales de una sola instrucción, no elementos de una hoja de ruta. Pega cualquiera de ellos en tu cliente MCP una vez que el servidor esté conectado.

• "Constrúyeme un panel de KPI en la hoja Q4 con ingresos, CAC, abandono y MRR, formateado, con colores condicionales." → una llamada a sheets_build_dashboard.

• "Crea una nueva hoja llamada Clients con estas 12 columnas, estilo de encabezado, validación de datos y la primera fila inmovilizada." → una llamada a sheets_build_sheet.

• "Encuentra todas las instancias de 'Q3 2025' en todas las pestañas de este libro y reemplázalas por 'Q4 2025'." → una llamada a sheets_find_replace_many.

• "Crea un Apps Script vinculado a esta hoja que me envíe un resumen por correo electrónico todos los lunes a las 8 a.m. y despliégalo como una aplicación web." → una llamada a script_deploy.

• "Inserta una tabla de precios de 5 columnas en este Google Doc con estas filas." → una llamada a docs_insert_table.

• "Crea una carpeta compartida en Drive, mueve estos tres archivos a ella y establece los permisos para que cualquier persona con el enlace pueda verlos."

• "Añade un formato condicional para resaltar en rojo cualquier fila donde el margen sea inferior al 15 por ciento."

• "Protege las fórmulas en la columna H para que nadie más en la hoja pueda editarlas."

Sin código. Sin pasos manuales. Sin cambiar de contexto fuera de tu cliente de IA.

¿Por qué otro servidor MCP de Google Workspace?

La mayoría de los MCP de Google en GitHub caen en una de dos categorías: conectores de solo lectura que pueden consultar una hoja de cálculo pero no cambiarla, o adaptadores limitados solo a Sheets que ignoran Docs, Drive y Apps Script por completo. Son conectores: envoltorios delgados alrededor de la API REST, entregados a una IA que luego tiene que gastar cuarenta llamadas a herramientas y una fortuna en tokens para lograr cualquier cosa.

google-suite-mcp no es un conector. Es un operador. Las primitivas son resultados (construir este panel, desplegar este script, formatear este informe), no endpoints (leer rango, escribir celda, listar archivo). Los operadores cubren toda la suite porque el trabajo real cruza herramientas. Los operadores ofrecen primitivas compuestas porque el trabajo real nunca es una edición de una sola celda.

Ellos hacen zig. Nosotros hacemos zag.

Comparación de capacidades

Requisitos

• Node.js 20 o posterior

• Una cuenta de Google con acceso a los archivos de Workspace que quieres que tu IA toque

• Un proyecto de Google Cloud (el nivel gratuito es suficiente)

• Credenciales de escritorio OAuth 2.0

• Un cliente compatible con MCP: Claude Desktop, Cursor, Windsurf, Zed, VS Code (GitHub Copilot), Gemini CLI, Cline, Goose, cualquier agente construido sobre el SDK de OpenAI Agents, o cualquier otro cliente que hable MCP

Calcula aproximadamente diez minutos para la configuración inicial si nunca has tocado Google Cloud antes. Hecho una vez, nunca más.

¿Cómo instalo google-suite-mcp?

npm install -g google-suite-mcp

O salta la instalación global y deja que tu cliente MCP lo obtenga bajo demanda mediante npx -y google-suite-mcp (consulta los bloques de configuración del cliente a continuación).

De cualquier manera, el servidor almacena sus credenciales y tokens OAuth en ~/.google-suite-mcp/. La primera vez que ejecutas una herramienta, te dice exactamente dónde colocar tu JSON de cliente OAuth de Google Cloud y abre un navegador para el consentimiento. Consulta SETUP.md para los pasos únicos de Google Cloud.

¿Cómo me conecto a Google Workspace?

Esta es la única parte de la configuración que necesita atención real. Cada enlace a continuación abre la página exacta de la Consola de Google Cloud donde vive tu próximo clic, por lo que nunca tienes que buscar nada.

Tutorial completo: SETUP.md tiene cada paso en orden con solución de problemas para los errores principales. La versión corta:

1. Crea un proyecto de Google Cloud (10 segundos, nivel gratuito)

2. Habilita las cuatro APIs (haz clic en cada enlace y presiona Habilitar):

   • Sheets API

   • Docs API

   • Drive API

   • Apps Script API

3. Configura la pantalla de consentimiento de OAuth: elige Externo y añade tu propio correo electrónico de Google como usuario de prueba

4. Crea un cliente de escritorio OAuth 2.0: Crear credenciales > ID de cliente OAuth > Aplicación de escritorio. Copia el ID de cliente y el Secreto de cliente.

5. Pega las credenciales en .env:

   cp .env.example .env

   Luego edita .env y pega el ID de cliente y el Secreto de cliente del paso 4.

La primera vez que el servidor ejecuta una herramienta, abre tu navegador, te guía a través del flujo de consentimiento de Google y almacena en caché el token de actualización localmente. No volverás a autenticarte a menos que revoques el acceso.

Si te quedas atascado en algún paso, pega SETUP.md en tu asistente de IA y pídele que te guíe paso a paso.

¿Cómo conecto mi cliente MCP?

Cada cliente compatible con MCP acepta las mismas dos cosas: un command para ejecutar y una lista de args. Los bloques a continuación usan npx para que nunca tengas que gestionar una ruta de instalación local.

Claude Desktop

Abre tu archivo de configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade esta entrada:

{
  "mcpServers": {
    "google-suite": {
      "command": "npx",
      "args": ["-y", "google-suite-mcp"]
    }
  }
}

Reinicia Claude Desktop. Las 82 herramientas aparecerán en el selector de herramientas.

Cursor, Windsurf, Zed, VS Code

Cada cliente tiene su propia ubicación de configuración de MCP pero acepta la misma forma de command y args. Consulta los documentos de MCP de tu cliente y pega el bloque anterior bajo su sección de servidor MCP. No se requieren otros cambios.

Gemini CLI

Añade el servidor a tu configuración de MCP de Gemini CLI (~/.gemini/config.json o equivalente) usando el mismo command y args.

OpenAI Agents SDK

El SDK de OpenAI Agents (Python y TypeScript) admite servidores MCP de forma nativa. Pasa google-suite-mcp como un servidor MCP al construir tu agente y las 82 herramientas estarán disponibles para cualquier modelo de OpenAI que elijas.

Cualquier otro cliente MCP

Si habla el Protocolo de Contexto de Modelo, funciona. Usa el mismo patrón de command y args donde sea que tu cliente defina los servidores MCP.

Ejemplos de uso

Una vez que el servidor está conectado, hablas con tu IA como siempre lo has hecho. Solo que ahora tiene manos.

Construir un panel de KPI en vivo a partir de un esquema

"En el libro titulado 'Q4 Forecast', crea una nueva pestaña llamada 'Dashboard' y construye un panel de KPI con cuatro celdas: Ingresos, Margen Bruto, CAC y Abandono. Extrae los valores de la pestaña 'Raw', formatea los encabezados en negrita, los números como moneda y resalta en rojo cualquier cosa por debajo del objetivo."

Una llamada a sheets_build_dashboard. Listo.

Convertir un esquema en una hoja

"Crea una nueva hoja llamada 'Client Tracker' con columnas para Nombre, Correo electrónico, Estado (desplegable: Lead / Active / Churned), Último contacto (fecha) y Notas. Añade formato condicional para que las filas 'Churned' se vuelvan rojas."

Una llamada a sheets_build_sheet. Listo.

Escribir un documento con estructura real

"Redacta el resumen de inicio para el proyecto Henderson en Docs. Incluye una tabla de partes interesadas, una tabla de cronograma y una sección de riesgos con viñetas."

docs_insert_table te da tablas reales, no imitaciones ASCII.

Desplegar una aplicación web de Apps Script

"Crea un nuevo proyecto de Apps Script vinculado a esta hoja, añade un doGet que devuelva la pestaña Summary como JSON, asígnale una versión y despliégalo como una aplicación web que pueda consultar con curl."

script_deploy lo publica. Obtienes una URL en vivo.

Renombrar un campo en todas las hojas de un libro

"En el libro de Gastos, reemplaza cada aparición de 'customer_id' por 'account_id' en todas las hojas en una sola pasada."

sheets_find_replace_many lo maneja en una sola llamada.

Organizar Drive

"Crea una carpeta llamada '2026 Client Intake', mueve todos los archivos en mi Drive con 'intake' en el nombre a ella y comparte la carpeta con acceso de visualización a cualquier persona con el enlace."

Resumen de la lista de herramientas (82 herramientas)

Agrupadas por superficie de Google:

• Google Sheets (53 herramientas). Crear, listar, leer, escribir, añadir, formatear, formato condicional, gráfico, rango con nombre, rango protegido, filtro, ordenar, validación, bordes, combinar, inmovilizar paneles, cambiar tamaño, buscar/reemplazar (individual y sheets_find_replace_many en cada pestaña), buscar, fórmulas, fórmulas de matriz, actualización por lotes, duplicar, renombrar, reordenar, eliminar, sheets_build_sheet, sheets_build_dashboard.

• Google Docs (8 herramientas). Crear, escribir, formatear texto, obtener texto, reemplazar texto, insertar imagen, docs_insert_table, exportar.

• Google Drive (12 herramientas). Subir, descargar, buscar, obtener información, mover, copiar, renombrar, enviar a la papelera, crear carpeta, compartir, listar y actualizar permisos.

• Google Apps Script (7 herramientas). Crear, actualizar, obtener, obtener vinculado, ejecutar, crear versión, script_deploy.

• Autenticación (2 herramientas). Estado, actualizar.

Cada herramienta viene con respuestas eficientes en tokens. Cada carga útil fue auditada de extremo a extremo y ajustada para que tu ventana de contexto se mantenga ligera en ejecuciones agénticas largas.

Para obtener la lista autorizada con esquemas en vivo, llama a tools/list desde cualquier cliente MCP una vez conectado, o consulta src/tools/ en el árbol de fuentes.

Preguntas frecuentes

¿Funciona esto con Cursor, Gemini CLI u otros clientes MCP que no sean Claude?

Sí. google-suite-mcp es un servidor estándar del Protocolo de Contexto de Modelo. Cualquier cliente compatible con MCP (Claude Desktop, Cursor, Windsurf, Zed, VS Code con GitHub Copilot, Gemini CLI, Cline, Goose o cualquier agente construido sobre el SDK de OpenAI Agents) puede conectarse usando el mismo patrón de command y args mostrado arriba. Consulta los documentos de configuración de MCP de tu cliente para saber dónde pegar el bloque. MCP es un protocolo, no una función de Claude.

¿Puedo usar esto con modelos de OpenAI como GPT-4 o GPT-5?

Sí. El SDK de OpenAI Agents admite servidores MCP de forma nativa, por lo que cualquier agente que construyas sobre modelos de OpenAI puede montar google-suite-mcp y obtener las 82 herramientas. Al servidor no le importa qué modelo esté al otro lado de la conexión.

¿Puedo desplegar Apps Script desde la IA?

Sí. google-suite-mcp es uno de los