mcp-google-drive

Google Drive MCP

Español | Русский

A1 Google Drive MCP permite que una aplicación de IA trabaje con tu Google Drive en lenguaje natural. Encuentra un archivo, ordena carpetas, sube y descarga contenido, exporta un Documento como Markdown, compártelo con las personas adecuadas — y mantén la papelera entre tú y la eliminación permanente.

Utiliza la API de Google Drive con tu cuenta de Google. Ve tanto Mi unidad como unidades compartidas, trata "eliminar" como la papelera reversible y hace explícitos los límites de la API de Drive en lugar de dar a entender que cualquier tarea con archivos es posible.

• 21 herramientas. Búsqueda y metadatos, carpetas y movimiento, subida y descarga, exportación de Documentos/Hojas/Presentaciones, la papelera, uso compartido y comentarios.
• Se conecta desde la conversación. Di "conectar Google Drive": el servidor te guía a través del cliente OAuth, captura la redirección de Google en 127.0.0.1 con PKCE y guarda los tokens él mismo — sin archivos de configuración, sin reinicio.
• La papelera es lo primero. "Eliminar" significa la papelera reversible; la eliminación permanente es una herramienta deliberadamente separada que no se puede elegir por accidente.
• Los documentos permanecen intactos. Documentos, Hojas y Presentaciones se mueven, copian, exportan y convierten como archivos completos — el servidor nunca edita el texto dentro de ellos.
• Tú eliges el alcance. drive.readonly cubre toda lectura y drive.file limita el acceso a archivos creados por la aplicación; la superficie completa de herramientas necesita drive.

Comienza con una pregunta de solo lectura:

Encuentra el documento de la hoja de ruta del proyecto en mi Drive, expórtalo a Markdown y resúmelo.

Conectar el servidor · Explorar casos de uso · Abrir documentación técnica

Vélo funcionar en un minuto

Tú: Muéstrame qué hay en la carpeta "Contratos 2025", del más reciente al más antiguo.

Asistente: Lista los archivos con sus tipos, propietarios y fechas de modificación. Nada cambia.

Tú: Prepara una subcarpeta "Archivo" y mueve todo lo que tenga más de un año.

Asistente: Muestra la carpeta que crearía y los archivos que movería, luego pide confirmación.

Tú: Confirmo.

Asistente: Crea la carpeta y mueve los archivos. Nada se comparte, se envía a la papelera o se elimina a menos que lo pidas por separado.

Contenido

• Inicio rápido
• Qué puedes pedirle que haga
• Cómo cambia tu Drive
• Qué puede cambiar
• Obtener acceso
• Configuración
• Datos, límites y trabajo en segundo plano
• Documentación técnica
• Soporte

Inicio rápido

Necesitas Node.js 20+ y una cuenta de Google. No se requieren credenciales al momento de la instalación — el servidor se conecta desde la conversación.

1. Añade el servidor a tu aplicación de IA.
2. Di "conectar Google Drive": el asistente te guía a través de crear el cliente OAuth y aprobar el acceso sin editar archivos de configuración.
3. Haz la pregunta de solo lectura anterior.

codex mcp add google-drive \
  -- npx -y @a1-x-tech/mcp-google-drive@latest

codex mcp list

claude mcp add \
  --transport stdio --scope user google-drive \
  -- npx -y @a1-x-tech/mcp-google-drive@latest

claude mcp list

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-drive@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-drive@latest"]
    }
  }
}

{
  "servers": {
    "google-drive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-drive@latest"]
    }
  }
}

Qué puedes pedirle que haga

Encontrar y leer archivos

• Encuentra la hoja de cálculo del presupuesto del último trimestre y muestra dónde está y quién es el propietario.
• Exporta el resumen del proyecto a Markdown y resume las preguntas abiertas.
• Descarga el PDF del contrato firmado en mi carpeta de informes.

Organizar y transferir contenido

• Crea una carpeta "Informes 2026" y mueve los informes mensuales a ella.
• Sube estas notas de la reunión y conviértelas en un Documento de Google.
• Copia la plantilla de propuesta y renombra la copia para el nuevo cliente.

Compartir y discutir

• Comparte la carpeta con un compañero como comentarista y añade una nota a la invitación.
• Lista los comentarios abiertos en el documento de diseño y resuelve los que ya hemos abordado.
• Revoca el acceso del contratista externo al archivo.

Limpiar deliberadamente

• Envía los borradores obsoletos a la papelera — y restaura el que se eliminó por error.
• Elimina permanentemente la carpeta de subidas de prueba una vez que confirme.
• Muestra qué hay en la papelera antes de purgar cualquier cosa.

Cómo cambia tu Drive

1. Todo en Drive — incluidas las carpetas y los elementos de unidades compartidas — es un archivo con un id. Los nombres no son únicos, por lo que las herramientas actúan sobre ids, y los nombres duplicados son legales: conviene buscar antes de crear.
2. "Eliminar" significa la papelera: reversible, purgada automáticamente por Google después de unos 30 días. La eliminación permanente omite la papelera, arrastra los subárboles de carpetas y vive en una herramienta deliberadamente separada.
3. Los Documentos, Hojas y Presentaciones de Google se mueven, copian, comparten, exportan y convierten como unidades completas. El servidor no tiene ninguna herramienta que edite texto dentro de un Documento o celdas dentro de una Hoja.
4. Una escritura nunca se reproduce después de un fallo incierto: los reintentos después de errores de red y 5xx se aplican solo a lecturas, por lo que una copia, subida o nueva carpeta no puede duplicarse a tus espaldas.

Las subidas integradas están limitadas a 5 MB (los archivos más grandes pasan por una sesión reanudable mediante raw_request), las exportaciones a 10 MB según la API de Drive. Los comentarios creados a través de la API no se pueden anclar a un pasaje específico dentro de un Documento.

Qué puede cambiar

El cliente de IA controla los avisos de confirmación. El servidor marca lecturas, escrituras y herramientas destructivas para que el cliente pueda distinguir una inspección de un cambio en vivo.

Obtener acceso

Google Drive requiere OAuth 2.0; una clave de API no es suficiente. Hay dos formas de entrar, y la primera no necesita archivos de configuración.

Conectar desde el chat (recomendado)

Di "conectar Google Drive" y el asistente ejecuta el flujo contigo:

1. setup_instructions imprime la lista de verificación: crea o selecciona un proyecto de Google Cloud, habilita Google Drive API, configura la pantalla de consentimiento y crea un cliente OAuth de Aplicación de escritorio.
2. Descarga el JSON de ese cliente ("Download JSON") y dale al asistente su ruta — set_client lo almacena solo para el propietario. El secreto nunca pasa por la conversación.
3. start_login devuelve un enlace de consentimiento de Google. Ábrelo en esta máquina y aprueba; el código vuelve a un listener de un solo uso en 127.0.0.1 (PKCE), nunca a través del chat.
4. finish_login intercambia el código y guarda los tokens en ~/.config/mcp-google-drive/credentials.json (modo 0600) y los verifica con una llamada real a la API de Google Drive — por lo que una API que aún está desactivada se detecta allí mismo.

Los tokens se releen en cada llamada, por lo que la conexión funciona de inmediato — sin reiniciar la aplicación de IA. auth_status muestra qué está conectado, logout revoca y elimina.

Variables de entorno (CI, instalaciones desatendidas)

1. Crea o selecciona un proyecto de Google Cloud y habilita Google Drive API.

2. Configura la pantalla de consentimiento OAuth y crea un cliente OAuth de Aplicación de escritorio.

3. Autoriza la cuenta de Google con cuyos archivos debe trabajar el servidor. El OAuth 2.0 Playground puede obtener el token de actualización cuando Use your own OAuth credentials está habilitado.

4. Solicita el alcance más restringido que cubra tu uso:

   Alcance	Habilita
   https://www.googleapis.com/auth/drive.readonly	Las herramientas de solo lectura: búsqueda, metadatos, descarga, exportación y listado de unidades compartidas.
   https://www.googleapis.com/auth/drive.file	Solo archivos creados o abiertos por esta aplicación — suficiente para flujos de subida y organización en archivos propiedad de la aplicación.
   https://www.googleapis.com/auth/drive	La superficie completa de herramientas: uso compartido, papelera, eliminación y comentarios en archivos arbitrarios.

El servidor usa el alcance con el que se emitió el token de actualización; una llamada fuera de él falla con un error insufficientPermissions.

Los tokens de actualización de OAuth en modo de prueba pueden caducar después de siete días. Publica la aplicación OAuth, o usa una aplicación Interna en un dominio de Workspace, cuando necesites acceso de larga duración. Trata el secreto del cliente y el token de actualización como contraseñas.

Configuración

Cada variable es opcional — sin ninguna de ellas el servidor se conecta desde el chat.

* Proporciona el trío OAuth o un token de acceso.

Sin ninguna credencial, el servidor aún se inicia y completa el protocolo de enlace MCP; la primera llamada a una herramienta responde con las variables exactas a configurar en lugar de un servidor muerto.

Datos, límites y trabajo en segundo plano

• Las solicitudes van a Google Drive. El servidor local actualiza los tokens OAuth de Google y llama a la API de Drive. Su telemetría anónima contiene un ID de instalación, versión del paquete, cliente de IA y versiones de plataforma, y nombres de herramientas — nunca tokens OAuth, contenido de archivos, argumentos de herramientas o indicaciones. Establece ASKADS_TELEMETRY=0 para optar por no participar.
• Google aplica cuotas y límites de tamaño. Las subidas a través de la herramienta integrada están limitadas a 5 MB y las exportaciones a 10 MB. En 429, el servidor usa retroceso; las lecturas también se reintentan después de errores de red y 5xx, mientras que las escrituras no se reproducen después de una falla incierta.
• Los archivos locales se manejan con precaución. Las descargas se guardan solo en rutas absolutas y se niegan a sobrescribir un archivo existente a menos que se solicite; las devoluciones en línea se limitan a 100 KB de contenido textual.
• No hay sondeo en segundo plano. El servidor se ejecuta solo cuando se llama; nada vigila tu Drive entre solicitudes. Si tu aplicación de IA admite tareas programadas, puede verificar cambios periódicamente.

Documentación técnica

• Catálogo de capacidades de MCP — páginas orientadas a tareas para cada herramienta.
• Todas las herramientas y entradas
• Documentación de desarrollo
• Documentación de publicación
• Referencia de la API de Google Drive

Soporte

¿Encontraste un error o necesitas un escenario? Crea un problema o escribe en Telegram.

¡Llegaste al final!