Google Sheets MCP

Google Sheets MCP

Un servidor de Model Context Protocol (MCP) que le da a Claude (y a otros clientes MCP) acceso de lectura/escritura a cualquier hoja de Google mediante OAuth.

Herramientas

Herramienta	Descripción
read_sheet	Leer datos de cualquier rango en una hoja de cálculo
write_sheet	Escribir o actualizar datos en una hoja de cálculo
append_rows	Añadir nuevas filas a una hoja de cálculo
get_sheet_info	Obtener nombres de hojas, recuentos de filas y recuentos de columnas
clear_range	Limpiar un rango de celdas

Todas las herramientas aceptan una URL completa de Google Sheets o un ID de hoja de cálculo simple.

---

Requisitos previos

• Node.js 18+
• Una cuenta de Google
• Un proyecto de Google Cloud (gratuito)

---

Configuración

1. Clonar el repositorio

git clone https://github.com/generalist-club/google-sheets-mcp.git
cd google-sheets-mcp
npm install

2. Crear un proyecto de Google Cloud y credenciales OAuth

1. Ve a Google Cloud Console
2. Crea un nuevo proyecto (o selecciona uno existente)
3. Habilita la API de Google Sheets y la API de Google Drive:
   • Navega a APIs y servicios → Biblioteca
   • Busca y habilita ambas APIs
4. Crea credenciales OAuth:
   • Navega a APIs y servicios → Credenciales
   • Haz clic en Crear credenciales → ID de cliente OAuth
   • Tipo de aplicación: Aplicación de escritorio
   • Descarga el archivo JSON
5. Renombra el archivo descargado a credentials.json y colócalo en la raíz del proyecto

3. Autenticación

Ejecuta el script de autenticación para generar tu token:

node auth.js

Imprimirá una URL. Ábrela en tu navegador, autoriza la aplicación y luego pega el código de vuelta en la terminal. Esto crea un archivo token.json localmente — mantenlo en secreto.

Renovación del token: El servidor renueva automáticamente el token de acceso cuando caduca. Solo deberías necesitar ejecutar auth.js una vez.

4. Configurar Claude Desktop (o cualquier cliente MCP)

Añade este servidor a tu configuración de Claude Desktop en ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "google-sheets": {
      "command": "node",
      "args": ["/absolute/path/to/google-sheets-mcp/index.js"]
    }
  }
}

Reemplaza /absolute/path/to/google-sheets-mcp con la ruta real en tu máquina.

Reinicia Claude Desktop. Las cinco herramientas de Google Sheets estarán ahora disponibles.

---

Ejemplos de uso

Una vez conectado, puedes pedirle a Claude cosas como:

• "Lee los datos de esta hoja de cálculo: https://docs.google.com/spreadsheets/d/..."
• "Añade una nueva fila con la fecha de hoy y 42 a Sheet1"
• "¿Qué hojas hay en este libro y cuántas filas tiene cada una?"
• "Limpia el rango B2:D10 en mi hoja de cálculo"

---

Notas de seguridad

• credentials.json y token.json están excluidos de git mediante .gitignore — nunca los confirmes
• El token OAuth se almacena localmente y solo otorga acceso a tu propia cuenta de Google
• Ámbitos solicitados: spreadsheets (lectura/escritura) y drive.readonly (para resolver metadatos de hojas)

---

Licencia

MIT