Miércoles, 22 de julio de 2026  ·  LATAM / Español
ÚLTIMA HORA
Anthropic lanza mejoras en la API de Claude para América Latina  ·  MCP 2026-07-28 ya en release candidate  ·  Claude Sonnet 5 supera benchmarks de coding agéntico  ·  Claude Code alcanza $1B de run-rate en 6 meses  ·  NSA publica guía de seguridad para el protocolo MCP
Hace 45 min →
Intermedio 40 min en total 6 pasos

Cómo conectar Claude con Google Drive paso a paso

Integra tus documentos de Google Drive en Claude usando conectores nativos y MCP para consultar archivos reales.

Imagen de portada editorial · Cómo conectar Claude con Google Drive paso a paso · Educación · Claude Builders
Requisitos
  • Cuenta de Claude (plan Pro, Team o Enterprise para conectores nativos)
  • Cuenta de Google con acceso a Google Drive
  • Node.js 18+ instalado (para la ruta MCP)
  • Clave API de Anthropic si usas la API
  • Conocimientos básicos de terminal y JSON
Lo que vas a aprender
  • Activar el conector nativo de Google Drive en Claude.ai
  • Autorizar el acceso OAuth con permisos mínimos
  • Configurar un servidor MCP de Google Drive para la API
  • Consultar, buscar y resumir documentos reales desde Claude
  • Evitar errores comunes de permisos y scopes
PASO 1 · ~5 min

Activar el conector de Google Drive en Claude.ai

La vía más rápida no requiere código. Entra en claude.ai, abre el menú de configuración (tu avatar arriba a la derecha) y ve a 'Settings' > 'Connectors' o 'Integraciones'. Busca 'Google Drive' en el listado de conectores disponibles. Este conector está disponible en los planes Pro, Team y Enterprise; si estás en plan gratuito no aparecerá. Pulsa 'Connect' junto a Google Drive. Esto es ideal para builders en España y LATAM que quieren consultar documentación interna sin montar infraestructura. El conector permite que Claude busque y lea archivos bajo demanda, no sube todo tu Drive a Anthropic: solo accede a lo que menciones en la conversación. Verifica que estás con la cuenta de Google correcta antes de continuar, sobre todo si mezclas cuenta personal y corporativa.

ConsejoSi no ves Google Drive en Connectors, revisa que tu administrador de Workspace no haya bloqueado apps de terceros en la consola de Google Admin.
Error comúnEl plan gratuito de Claude no incluye conectores nativos; necesitas al menos Pro.
PASO 2 · ~5 min

Autorizar el acceso OAuth con permisos mínimos

Al pulsar 'Connect' se abre la pantalla de consentimiento de Google. Aquí decides qué puede leer Claude. Google mostrará los scopes solicitados: normalmente lectura de archivos y metadatos ('drive.readonly' o 'drive.file'). Revisa cada permiso: para la mayoría de casos de consulta y resumen, solo necesitas lectura. Selecciona la cuenta correcta, acepta y serás redirigido de vuelta a Claude con el estado 'Connected'. Si tu organización usa Google Workspace con verificación de apps, puede que veas un aviso de 'app no verificada' o que se requiera aprobación del admin. En ese caso, coordina con tu equipo de IT antes de seguir. Una vez conectado, Claude puede acceder a Drive solo durante tus conversaciones y bajo tu identidad, respetando los permisos que ya tienes sobre cada archivo. Nunca concedas 'acceso total a Drive' si solo necesitas leer documentos concretos.

ConsejoUsa una cuenta de Google dedicada a documentación si trabajas con datos sensibles, así limitas el alcance del token.
Error comúnEvita conceder scopes de escritura ('drive') si solo vas a leer; reduce la superficie de riesgo.
PASO 3 · ~5 min

Probar la conexión pidiendo un documento real

Con el conector activo, abre una conversación nueva y pídele a Claude que busque algo concreto de tu Drive. El modelo detectará que necesita usar la herramienta de Google Drive y te mostrará qué archivo va a consultar. Sé específico: menciona el nombre del documento o una palabra clave que aparezca en él. Claude buscará, leerá el contenido y responderá basándose en él. Este flujo es perfecto para resúmenes de actas, revisión de propuestas o extracción de datos de hojas de cálculo. Verás que en la respuesta aparece una referencia al archivo fuente, lo que te permite auditar de dónde salió cada dato. Si Claude no encuentra el archivo, prueba con el nombre exacto o comparte el documento con la cuenta conectada.

code
Busca en mi Google Drive el documento "Plan de Marketing Q1 2025"
y resúmeme los tres objetivos principales en bullets.
Indica de qué archivo has sacado la información.
ConsejoPide siempre que cite el archivo fuente: te da trazabilidad y detecta cuándo Claude responde de memoria en vez de leer el Drive.
Error comúnClaude solo ve archivos a los que tu cuenta tiene acceso; si el doc está en un Drive compartido sin permiso, no lo encontrará.
PASO 4 · ~10 min

Configurar la ruta MCP para uso programático

Si quieres integrar Google Drive con la API de Claude (por ejemplo dentro de tu propia app o agente), usa el Model Context Protocol (MCP). MCP es el estándar abierto de Anthropic para conectar modelos con herramientas externas. Primero instala un servidor MCP de Google Drive. Necesitarás credenciales OAuth de un proyecto en Google Cloud Console: crea un proyecto, habilita la API de Google Drive y genera un 'OAuth client ID' de tipo aplicación de escritorio. Descarga el JSON de credenciales. Luego instala el servidor MCP mediante npx. Este servidor expone herramientas como buscar y leer archivos que Claude podrá invocar. Guarda las credenciales fuera del control de versiones. Esta ruta es la que usarías en producción para agentes que consultan documentación de forma autónoma.

bash
# Instala el servidor MCP de Google Drive
npx -y @modelcontextprotocol/server-gdrive

# Coloca tus credenciales OAuth descargadas de Google Cloud
export GDRIVE_CREDENTIALS_PATH=./gcp-oauth.keys.json

# La primera ejecución abrirá el navegador para autorizar
npx -y @modelcontextprotocol/server-gdrive auth
ConsejoHabilita también la API de Google Sheets en Cloud Console si vas a leer hojas de cálculo; comparten el mismo flujo OAuth.
Error comúnNunca subas gcp-oauth.keys.json ni el token generado a Git; añádelos al .gitignore inmediatamente.
PASO 5 · ~5 min

Registrar el servidor MCP en tu cliente

Para que Claude Desktop o tu propia aplicación usen el servidor, hay que declararlo en la configuración MCP. En Claude Desktop edita el archivo claude_desktop_config.json (en macOS está en ~/Library/Application Support/Claude/). Añade una entrada 'mcpServers' apuntando al servidor de Google Drive y a tus credenciales. Reinicia Claude Desktop y verás el icono de herramientas MCP activo. A partir de ahí puedes pedir consultas igual que con el conector nativo, pero controlando tú la infraestructura. Si integras vía API con el SDK, defines el servidor MCP en la configuración de tu cliente de agente. Verifica el arranque revisando los logs: un error habitual es una ruta mal escrita a las credenciales.

json
{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gdrive"],
      "env": {
        "GDRIVE_CREDENTIALS_PATH": "/ruta/absoluta/gcp-oauth.keys.json"
      }
    }
  }
}
ConsejoUsa rutas absolutas en GDRIVE_CREDENTIALS_PATH; las relativas fallan según desde dónde arranque el proceso.
Error comúnSi editas mal el JSON (una coma de más), Claude Desktop ignora toda la config sin avisar. Valida el JSON antes de guardar.
PASO 6 · ~10 min

Orquestar consultas desde la API con claude-opus-4-8

Con el servidor MCP en marcha, puedes construir un agente que consulte Drive automáticamente. Usa el SDK de Anthropic, apunta al modelo claude-opus-4-8 y pásale la configuración del servidor MCP. El modelo decidirá cuándo llamar a las herramientas de Google Drive para responder. Este patrón es la base de cualquier asistente que necesite datos vivos de tu documentación. Empieza con una tarea acotada (buscar y resumir) antes de dar al agente permisos de escritura o encadenar varios pasos.

python
import anthropic

client = anthropic.Anthropic()  # usa ANTHROPIC_API_KEY del entorno

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "Busca en Google Drive el acta de la reunion de ayer y extrae las tareas asignadas con su responsable."
    }],
    mcp_servers=[{
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-gdrive"]
    }]
)

print(response.content)
ConsejoGuarda ANTHROPIC_API_KEY en variables de entorno o un gestor de secretos, nunca en el código fuente.
Error comúnEl token OAuth de Google caduca; si el agente empieza a fallar con errores 401, vuelve a ejecutar el flujo de auth del paso 4.
Resultado

Has conectado Claude con Google Drive por dos vías: el conector nativo en claude.ai para consultas rápidas sin código, y un servidor MCP para integrarlo en tus propios agentes vía API. Ahora Claude puede buscar, leer y resumir documentos reales de tu Drive respetando tus permisos. Dominar este flujo de agentes e integraciones con MCP te abre la puerta a asistentes que trabajan con tu documentación viva en lugar de datos estáticos.

PRÓXIMOS PASOS