Google Sheets MCP

Google Sheets MCP

Un conector del Model Context Protocol (MCP) para Google Sheets que permite a los agentes de IA interactuar directamente con hojas de cálculo.

Demostración

https://github.com/user-attachments/assets/cc4729d9-4e6e-437b-848b-6da9a09418c3

Configuración

1. Clona este repositorio:

git clone https://github.com/mkummer225/google-sheets-mcp
cd google-sheets-mcp

2. Instala las dependencias: npm install

3. Compila: npm run build

4. Crea credenciales OAuth en Google Cloud Platform:

   • Crea un nuevo proyecto en Google Cloud Console
   • Habilita la Google Sheets API
   • Configura la pantalla de consentimiento de OAuth
   • Crea credenciales de ID de cliente OAuth (aplicación de escritorio) con una URI de redireccionamiento adecuada (p. ej.: http://localhost:3000/oauth2callback)
   • Descarga las credenciales y guárdalas como gcp-oauth.keys.json en el subdirectorio dist

5. Inicia el servidor MCP (se te pedirá automáticamente que autentiques o vuelvas a autenticar tu cuenta de Google cuando sea necesario): npm run start

Uso

Configuración de ejemplo:

{
    "mcpServers": {
    "google-sheets-mcp": {
      "command": "node",
      "args": [
        "/{path_to_dir}/google-sheets-mcp/dist/index.js"
      ]
    }
  }
}

A continuación, podrás simplemente especificar tu spreadsheetId o pedirle a tu agente que cree uno nuevo por ti.

Acciones disponibles

Acción	Descripción
refresh_auth	Vuelve a autenticar tu cuenta de Google cuando caduquen las credenciales
list_sheets	Enumera todas las hojas/pestañas de una hoja de cálculo de Google
create_sheet	Crea una nueva hoja/pestaña en una hoja de cálculo de Google
create_spreadsheet	Crea una nueva hoja de cálculo de Google
read_all_from_sheet	Lee todos los datos de una hoja especificada
read_headings	Lee los encabezados de columna de una hoja
read_rows	Lee filas específicas de una hoja
read_columns	Lee columnas específicas de una hoja
edit_cell	Edita una sola celda en una hoja
edit_row	Edita una fila completa en una hoja
edit_column	Edita una columna completa en una hoja
insert_row	Inserta una nueva fila en la posición especificada
insert_column	Inserta una nueva columna en la posición especificada
rename_sheet	Cambia el nombre de una hoja/pestaña en una hoja de cálculo
rename_doc	Cambia el nombre de una hoja de cálculo de Google

Licencia

MIT