google-drive-mcp

Un servidor MCP local que ofrece a Claude Code acceso completo a Google Drive — buscar, leer, subir, renombrar, mover y cambiar permisos de uso compartido — incluso en archivos que ya existen en tu Drive (no solo los que crea esta aplicación).

Solicita deliberadamente el amplio ámbito https://www.googleapis.com/auth/drive, porque las tareas para las que está diseñado (renombrar, mover y cambiar permisos de uso compartido en archivos de cursos existentes) son imposibles con el ámbito más restrictivo drive.file.

Configuración única

Esto se hace una vez. Después, cada sesión de Claude Code puede usar las herramientas de google-drive.

Paso 1 — Crear un proyecto de Google Cloud (omítelo si ya tienes uno)

1. Ve a https://console.cloud.google.com/.

2. Barra superior → menú desplegable del proyecto → Nuevo proyecto.

3. Ponle un nombre como app-integrations → Crear. Espera unos segundos, luego asegúrate de que ese proyecto esté seleccionado en la barra superior.

Paso 2 — Habilitar la API de Google Drive

1. Ve a https://console.cloud.google.com/apis/library/drive.googleapis.com.

2. Confirma que tu proyecto esté seleccionado → haz clic en Habilitar.

Paso 3 — Configurar la pantalla de consentimiento de OAuth

1. Ve a https://console.cloud.google.com/auth/overview (API y Servicios → Pantalla de consentimiento de OAuth).

2. Si se te solicita, elige Tipo de usuario: externo → Crear. (Externo es válido para una cuenta personal de Google; solo serás un "usuario de prueba").

3. Rellena los campos obligatorios:

   • Nombre de la aplicación: google-drive-mcp (cualquier nombre vale)

   • Correo electrónico de soporte al usuario: tu correo

   • Correo electrónico de contacto del desarrollador: tu correo

   • Guardar y continuar.

4. Página Ámbitos: no es necesario añadir ámbitos aquí — el servidor los solicita en el momento de la autenticación. Guardar y continuar.

5. Página Usuarios de prueba: haz clic en + Añadir usuarios y añade tu propio correo de Google (tu propia cuenta de Google). Esto es necesario mientras la aplicación esté en "Pruebas". Guardar y continuar.

No es necesario publicar la aplicación ni pasar por la verificación de Google. Una aplicación en estado de Pruebas funciona indefinidamente para los usuarios de prueba que hayas listado; un token de actualización para una aplicación en Pruebas puede caducar después de 7 días de inactividad — si alguna vez las herramientas de Drive empiezan a fallar con un error de autenticación, simplemente vuelve a ejecutar npm run auth (Paso 6).

Paso 4 — Crear el cliente OAuth (aplicación de escritorio)

1. Ve a https://console.cloud.google.com/auth/clients (API y Servicios → Credenciales).

2. + Crear Credenciales → ID de cliente OAuth.

3. Tipo de aplicación: Aplicación de escritorio. Ponle nombre desktop-mcp → Crear.

4. En el diálogo, haz clic en Descargar JSON.

Paso 5 — Colocar el archivo del cliente donde el servidor lo espera

Guarda ese JSON descargado exactamente en esta ruta/nombre:

~/.config/google-drive-mcp/gcp-oauth.keys.json

Por ejemplo, si se descargó en ~/Downloads/client_secret_XXXX.json:

mkdir -p ~/.config/google-drive-mcp
mv ~/Downloads/client_secret_*.json ~/.config/google-drive-mcp/gcp-oauth.keys.json

Paso 6 — Autorizar (una vez)

cd ~/mcp-servers/google-drive-mcp
npm run auth

Esto imprime una URL y abre tu navegador. Inicia sesión con la cuenta de Google cuyo Drive quieres gestionar. Verás una advertencia "Google no ha verificado esta aplicación" (esperable, porque la aplicación está en Pruebas) → Avanzado → Ir a google-drive-mcp (no seguro) → Continuar → permite el permiso de Drive.

Si tiene éxito, escribe ~/.config/google-drive-mcp/.gdrive-credentials.json (tu token de actualización — mantenlo privado; ya está con chmod 600).

Paso 7 — Usarlo

El servidor ya está registrado en ~/.claude.json bajo el nombre google-drive. Inicia una nueva sesión de Claude Code y las herramientas gdrive_* estarán disponibles. (Los servidores MCP se cargan al inicio de la sesión, por lo que una sesión iniciada antes del registro no los verá).

Prueba rápida manual opcional:

cd ~/mcp-servers/google-drive-mcp && npm start
# prints "google-drive-mcp: connected over stdio", then waits. Ctrl-C to quit.

Herramientas

Eliminar elementos

gdrive_trash es la opción recomendada. Es reversible, Drive conserva los elementos en la papelera durante 30 días y gdrive_untrash los devuelve a su lugar original.

gdrive_delete es permanente e irrecuperable — no llega a la papelera. Requiere un confirmName que coincida exactamente con el nombre actual del elemento, lo que fuerza una lectura de metadatos antes de destruir nada, por lo que un ID de archivo obsoleto o mal escrito falla de forma notoria en lugar de eliminar lo incorrecto. Eliminar una carpeta elimina todo su contenido.

Registro

Registrado en ambas configuraciones — se leen de forma independiente, por lo que registrar en una no hace que el servidor esté disponible en la otra:

• ~/.claude.json (Claude Code)

• ~/Library/Application Support/Claude/claude_desktop_config.json (Escritorio / Cowork)

Entrada idéntica en cada una:

"google-drive": {
  "command": "/opt/homebrew/bin/node",
  "args": ["/ABSOLUTE/PATH/TO/mcp-servers/google-drive-mcp/index.js"]
}

La ruta absoluta a node es obligatoria, no una elección de estilo. Una aplicación iniciada desde Finder o al iniciar sesión hereda el PATH mínimo de launchd (/usr/bin:/bin:/usr/sbin:/sbin), en el que /opt/homebrew/bin/node de Homebrew es completamente invisible. Un simple "node" funciona cada vez que lo pruebas desde una terminal y falla cada mañana. ~/mcp-servers/trello-mcp/doctor.py verifica cada servidor en ambas configuraciones para esto.

Si instalas la CLI de claude más tarde, el comando equivalente es:

claude mcp add --scope user google-drive -- /opt/homebrew/bin/node ~/mcp-servers/google-drive-mcp/index.js

Archivos

• index.js — el servidor MCP (definiciones de herramientas)

• auth.js — flujo OAuth de bucle invertido único npm run auth

• lib-auth.js — ayudantes compartidos de OAuth/configuración

• ~/.config/google-drive-mcp/gcp-oauth.keys.json — tú lo proporcionas (Paso 5)

• ~/.config/google-drive-mcp/.gdrive-credentials.json — creado por npm run auth

Para el currículum / portafolio

Se mantiene aquí para que una futura sesión de currículum tenga la versión honesta en lugar de reconstruirla.

Por qué existe esto cuando ya hay un conector de Drive. Extiende el conector incorporado en lugar de reemplazarlo. La brecha es el trabajo masivo: renombrar cien archivos después de que una convención de nomenclatura cambie a mitad del proyecto es tedioso a mano, trivial de automatizar y vale la pena resolverlo de forma permanente en lugar de una sola vez. Ese fue el caso motivador.

Lo que realmente hice: establecí el objetivo y la restricción — una solución gratuita que ahorre el mismo tiempo en cada proyecto futuro, no un script de una sola vez para una carpeta.

Advertencia operativa conocida: el estado de publicación de la aplicación OAuth determina cuánto duran los tokens de actualización. En "Pruebas" caducan aproximadamente cada semana (invalid_grant); publicar la aplicación elimina ese límite para cada integración que comparta el proyecto de Cloud.

Viñeta de extensión de currículum: consulta la versión compartida en ~/mcp-servers/trello-mcp/README.md — estos tres se describen mejor juntos.

Caso de estudio completo: https://zeno-blade-creator.github.io/projects/personal-integrations.html