mcp-google-gdrive

Un servidor MCP para Google Drive, Docs, Sheets y Slides. Permite a los asistentes de IA gestionar archivos, carpetas, permisos, etiquetas y la papelera con acceso completo de lectura/escritura en múltiples cuentas de Google. Incluye conversión automática de formatos de Workspace (Docs a Markdown, Sheets a CSV/JSON, Slides a texto).

Herramientas

Gestión de cuentas

Archivos

Carpetas

Papelera

Permisos

Etiquetas

Google Docs

Google Sheets

Google Slides

Novedades en la v2.2

• Parámetro outputFormat — 12 herramientas de lectura/listado ahora aceptan outputFormat: "json" | "yaml" | "text". El valor predeterminado es json (compatible con versiones anteriores). Usa yaml para una salida estructurada o text para tablas compactas legibles por humanos. Compatible con: list_accounts, list_files, list_folder, list_trash, list_permissions, list_labels, list_file_labels, list_sheets, get_metadata, read_sheet_range, get_slide_thumbnail, search_files.

v2.1

• gdrive_download_file — Descarga cualquier archivo de Drive a una ruta de disco local. Los archivos de Workspace (Docs, Sheets, Slides) se exportan automáticamente al formato especificado (pdf, docx, xlsx, pptx, csv, txt, html o markdown).

• savePath en herramientas de exportación — gdrive_export_doc, gdrive_export_sheet y gdrive_export_slides ahora aceptan un parámetro opcional savePath. Cuando se proporciona, las exportaciones binarias (docx, pdf, xlsx, pptx) se guardan en el disco en lugar de devolverse como base64. Omitir savePath conserva el comportamiento de la v2.0.

• Resolución de correo electrónico en gdrive_list_accounts — Las cuentas migradas desde la v0.x que mostraban "migrated" en lugar de una dirección de correo electrónico ahora se resuelven automáticamente a través de la API userinfo de Google en la primera llamada.

• Correcciones de documentación — gdrive_empty_trash señala la consistencia eventual; gdrive_transfer_ownership señala la limitación entre organizaciones.

Formatos de salida

Todas las herramientas de lectura y listado admiten un parámetro outputFormat:

Ejemplo: gdrive_list_files({ query: "name contains 'report'", outputFormat: "text" }) devuelve:

files:
  id             name              mimeType         modifiedTime  size
  -------------  ----------------  ---------------  ------------  ----
  abc123def456   Q1 Report.pdf     application/pdf  2026-04-01    1024
  ghi789jkl012   Q2 Report.docx    application/pdf  2026-03-15    2048
resultCount: 2

Requisitos previos

• Node.js 18+

• Un proyecto de Google Cloud con estas APIs habilitadas:

  • Google Drive API

  • Google Docs API

  • Google Sheets API

  • Google Slides API

• Credenciales de aplicación de escritorio OAuth2

Configuración

1. Crea un proyecto en la Consola de Google Cloud y habilita las APIs de Drive, Docs, Sheets y Slides

2. Crea credenciales OAuth2 (Tipo de aplicación: Aplicación de escritorio) y descarga el archivo JSON

3. Guarda el archivo de credenciales:

mkdir -p ~/.config/mcp-google-gdrive
cp ~/Downloads/client_secret_*.json ~/.config/mcp-google-gdrive/credentials.json
chmod 600 ~/.config/mcp-google-gdrive/credentials.json

4. Ejecuta el flujo de autorización de una sola vez:

npx mcp-google-gdrive --auth primary

Esto imprime una URL para el consentimiento de Google. Después de otorgar acceso, pega el código de autorización en la terminal.

Configuración de múltiples cuentas

Añade cuentas adicionales con etiquetas únicas:

npx mcp-google-gdrive --auth work
npx mcp-google-gdrive --auth personal

Cada cuenta obtiene su propio archivo de token en ~/.config/mcp-google-gdrive/tokens/{label}.json. Usa el parámetro account en cualquier herramienta para especificar qué cuenta usar, o llama a gdrive_switch_account para cambiar la predeterminada.

Configuración

Gemini CLI

Añade a ~/.gemini/settings.json:

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

watsonx Orchestrate

orchestrate toolkits import --kind mcp \
  --name google-gdrive \
  --description "Google Drive, Docs, Sheets, Slides" \
  --command "npx -y mcp-google-gdrive" \
  --tools "*"

Claude Code

claude mcp add -s user google-gdrive -- npx -y mcp-google-gdrive

VS Code / Cursor

Añade a .vscode/mcp.json en tu espacio de trabajo:

{
  "mcpServers": {
    "google-gdrive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-gdrive"]
    }
  }
}

Autenticación

El servidor utiliza OAuth2 para el acceso a Google Drive. Las credenciales se almacenan localmente:

• ~/.config/mcp-google-gdrive/credentials.json — Cliente OAuth2 (compartido entre cuentas)

• ~/.config/mcp-google-gdrive/tokens/{label}.json — Tokens por cuenta (chmod 600)

• ~/.config/mcp-google-gdrive/config.json — Cuenta activa y registro de cuentas

Los tokens de acceso caducan después de una hora y se actualizan automáticamente utilizando los tokens de actualización almacenados. La actualización del token es transparente y no requiere interacción del usuario.

Migración desde la v0.x

Si actualizas desde una instalación de la v0.x de una sola cuenta, el servidor migra automáticamente tu token.json existente a tokens/primary.json en el primer inicio.

Servidores MCP relacionados

• mcp-redhat-account - Gestión de cuentas de Red Hat

• mcp-redhat-knowledge - Búsqueda en la base de conocimientos de Red Hat

• mcp-redhat-manpage - Páginas man de RHEL

• mcp-redhat-subscription - Gestión de suscripciones

• mcp-redhat-support - Gestión de casos de soporte

Licencia

MIT