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.

- 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
- 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
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.
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.
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.
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.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.
# 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 authRegistrar 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.
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-gdrive"],
"env": {
"GDRIVE_CREDENTIALS_PATH": "/ruta/absoluta/gcp-oauth.keys.json"
}
}
}
}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.
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)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.