Servidor MCP de Google Sheets

¿Qué hace el Servidor MCP de “Google Sheets”?

El Servidor MCP (Model Context Protocol) de Google Sheets es una herramienta basada en TypeScript que permite a los asistentes de IA interactuar de forma segura con Google Sheets a través de herramientas tipadas y bien definidas. Al actuar como puente entre agentes de IA y la API de Google Sheets/Drive, posibilita flujos de trabajo robustos de automatización y manipulación de datos. El servidor soporta tanto autenticación OAuth2 como Cuenta de Servicio, lo que lo hace flexible para distintos requisitos de seguridad. Su función principal es permitir a desarrolladores y flujos de IA realizar tareas como crear hojas de cálculo, leer y escribir datos de celdas, gestionar hojas y pestañas, y compartir documentos, todo de manera programática y segura. Esta integración agiliza operaciones como consultas tipo base de datos, edición colaborativa y automatización de flujos directamente en Google Sheets, mejorando la productividad y los procesos de desarrollo impulsados por IA.

Lista de Prompts

No se documentan plantillas de prompt explícitas en el repositorio.

Lista de Recursos

No se documentan recursos explícitos en el repositorio.

Lista de Herramientas

• create
  Crea una nueva hoja de cálculo y opcionalmente la mueve a una carpeta especificada de Drive.
• listSheets
  Lista todas las pestañas en una hoja de cálculo dada.
• renameSheet
  Renombra una pestaña existente.
• createSheet
  Añade una nueva pestaña a una hoja de cálculo.
• spreadsheetInfo
  Obtiene metadatos (título, IDs de hojas, propiedades de cuadrícula) de una hoja de cálculo.
• listSpreadsheets
  Lista todas las hojas de cálculo en tu carpeta de Drive configurada o en Mi Unidad.
• shareSpreadsheet
  Comparte una hoja de cálculo con usuarios (lector/comentarista/editor) y envía notificaciones.
• sheetData
  Lee los valores de celdas de una hoja y rango (o de toda la hoja).
• updateCells
  Escribe una matriz 2D de valores en un rango estilo A1.
• batchUpdate
  Aplica múltiples actualizaciones de rango en una sola solicitud.
• addRows / addColumns
  Inserta filas o columnas en un índice especificado.
• copySheet
  Copia una pestaña entre hojas de cálculo, con opción de renombrar.

Casos de Uso de este Servidor MCP

• Creación y Gestión Automatizada de Hojas de Cálculo
  Crea nuevas hojas, añade o renombra pestañas y organiza archivos en Google Drive, todo mediante flujos automatizados.
• Extracción y Actualización de Datos
  Lee y escribe grandes conjuntos de datos en Google Sheets, ideal para tuberías ETL, informes y automatización de dashboards.
• Acceso Colaborativo y Compartición
  Comparte hojas de cálculo de forma programática con distintos usuarios y asigna permisos, facilitando la colaboración en equipo y notificaciones automáticas.
• Operaciones en Lote y Manipulación de Datos
  Realiza actualizaciones por lotes, inserta múltiples filas/columnas y aplica cambios en hojas grandes de manera eficiente, ahorrando tiempo en tareas repetitivas.
• Duplicación y Organización de Pestañas
  Copia pestañas entre hojas para plantillas, copias de seguridad o flujos organizativos, soportando operaciones escalables en equipos.

Cómo configurarlo

Windsurf

1. Asegúrate de tener Bun (v1.0+) instalado y configura las credenciales de Google Cloud (OAuth2 o Cuenta de Servicio).
2. Clona el repositorio e instala las dependencias:
   git clone https://github.com/rohans2/mcp-google-sheets.git
cd mcp-google-sheets
bun install
3. Configura las variables de entorno como se muestra a continuación.
4. En el archivo de configuración de Windsurf, añade el servidor MCP usando un fragmento JSON.
5. Guarda la configuración y reinicia Windsurf.

Ejemplo de configuración JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Protegiendo las claves API con variables de entorno:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Claude

1. Instala los prerrequisitos y clona el repositorio.
2. Configura la autenticación de Google Cloud y las variables de entorno.
3. Localiza y edita el archivo de configuración MCP de Claude.
4. Añade el servidor MCP de Google Sheets con el fragmento de configuración.
5. Reinicia Claude y verifica la conexión.

Ejemplo de configuración JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cursor

1. Asegúrate de que Bun esté instalado y las credenciales configuradas.
2. Descarga y configura el repositorio.
3. Edita el archivo de configuración MCP de Cursor.
4. Incluye la entrada del servidor MCP de Google Sheets.
5. Guarda los cambios y reinicia Cursor para activar el servidor.

Ejemplo de configuración JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cline

1. Instala Bun y configura las credenciales de tu proyecto de Google Cloud.
2. Clona el repositorio e instala todas las dependencias necesarias.
3. Accede y edita la configuración del servidor MCP de Cline.
4. Registra el servidor MCP de Google Sheets usando el formato JSON.
5. Reinicia Cline para aplicar la configuración.

Ejemplo de configuración JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Protegiendo las claves API usando variables de entorno:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Cómo usar este MCP en flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo de FlowHunt, comienza agregando el componente MCP a tu flujo y conectándolo con tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración del sistema MCP, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "google-sheets": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una vez configurado, el agente de IA podrá usar este MCP como herramienta, con acceso a todas sus funciones y capacidades. Recuerda cambiar “google-sheets” por el nombre real de tu servidor MCP y reemplazar la URL por la de tu propio servidor MCP.

Resumen

Nuestra opinión

Este servidor MCP está bien documentado para su configuración y ofrece un conjunto robusto de herramientas para la automatización con Google Sheets. Sin embargo, carece de plantillas de prompt MCP explícitas y recursos, y no hay mención de sampling o soporte de roots. Su amplia cobertura de herramientas y la guía clara de seguridad lo hacen valioso para la automatización de hojas, pero podría mejorarse añadiendo documentación de prompts/recursos y aclarando el soporte de sampling/roots.

Puntaje MCP