Migrar correo de Gmail a Microsoft 365 con imapsync

imapsync copia mensajes y carpetas entre buzones accesibles por IMAP. Para migrar de Gmail a Microsoft 365, usa conexiones cifradas y autenticación OAuth 2.0; las políticas de ambos proveedores pueden requerir una aplicación OAuth aprobada, consentimiento administrativo o permisos específicos. Esta guía empieza con una simulación y mantiene intacto el buzón de origen [1][2][3].

Antes de empezar: comprueba que tienes autorización para acceder a ambos buzones, espacio suficiente en el destino y un plan de recuperación. Los tokens OAuth y la contraseña del buzón son credenciales sensibles.

Preparar el acceso

Gmail ofrece acceso IMAP y OAuth 2.0 mediante XOAUTH2. El acceso IMAP de Microsoft 365 también admite OAuth; la documentación de Microsoft identifica el permiso delegado https://outlook.office.com/IMAP.AccessAsUser.All [2][3].

Genera tokens para los dos buzones mediante un flujo OAuth de confianza y aprobado por el administrador correspondiente. imapsync puede leer el token de acceso de la primera línea de un archivo indicado mediante --oauthaccesstoken1 o --oauthaccesstoken2 [1]. Los tokens de acceso y de renovación permiten acceder al correo: limita quién puede leerlos y no los pegues en comandos, incidencias ni repositorios.

Guarda los archivos de token en una ruta privada y limita sus permisos al usuario que ejecutará la migración:

chmod 700 /ruta/privada
chmod 600 /ruta/privada/gmail.token /ruta/privada/microsoft365.token

Revisa el consentimiento de OAuth con especial cuidado: el alcance IMAP de Gmail https://mail.google.com/ permite acceso amplio al correo, y Microsoft 365 requiere el permiso IMAP correspondiente [2][3]. Al terminar la migración, elimina los tokens y revoca los permisos temporales cuando ya no sean necesarios.

Ejecutar una simulación

Primero confirma las direcciones de correo, los tokens y el alcance que va a procesar la herramienta. Las opciones --gmail1 y --office2 configuran los proveedores como origen y destino. Añade --dry para que imapsync informe de lo que haría sin copiar mensajes [1]:

imapsync --dry \
  --gmail1 --user1 usuario@gmail.com \
  --oauthaccesstoken1 /ruta/privada/gmail.token \
  --office2 --user2 usuario@example.com \
  --oauthaccesstoken2 /ruta/privada/microsoft365.token

Sustituye las direcciones y rutas de ejemplo. Revisa el resumen y los errores de autenticación, las carpetas detectadas y el número de mensajes previsto. Si se incluyen carpetas que no quieres migrar, define exclusiones explícitas y vuelve a ejecutar la simulación antes de copiar.

Copiar los mensajes

Cuando hayas revisado la simulación, ejecuta el mismo comando quitando únicamente --dry:

imapsync \
  --gmail1 --user1 usuario@gmail.com \
  --oauthaccesstoken1 /ruta/privada/gmail.token \
  --office2 --user2 usuario@example.com \
  --oauthaccesstoken2 /ruta/privada/microsoft365.token

No añadas --delete1 ni --delete1emptyfolders: la primera opción borra del origen los mensajes transferidos y la segunda elimina carpetas vacías del origen [1]. Para una migración de copia, conserva esas opciones fuera del comando.

Una migración grande puede durar más que la vigencia de un token de acceso. Comprueba el procedimiento de renovación OAuth y mantén los archivos actualizados y protegidos durante la ejecución. imapsync permite releer un token desde un archivo cuando necesita reconectarse [1].

Verificar el resultado

Al finalizar:

1. Revisa en el informe de imapsync si hubo errores, carpetas omitidas o mensajes no transferidos.
2. Compara recuentos de mensajes por carpeta, teniendo en cuenta que Gmail puede mostrar etiquetas como carpetas y tratar mensajes duplicados de forma distinta [1].
3. Abre mensajes y adjuntos representativos en el buzón de destino.
4. Ejecuta de nuevo el comando sin --dry para copiar mensajes que hayan llegado durante la primera pasada, si procede.
5. Mantén el buzón original sin cambios hasta que el propietario valide el correo migrado y exista una copia de seguridad adecuada.

La opción --dry sirve para revisar qué se haría; la documentación de imapsync señala que no ejecuta la transferencia real [1]. No es una prueba de recuperación ni sustituye la validación del buzón destino.

En resumen

• Usa OAuth 2.0 y conexiones TLS para los dos servicios.
• Trata los tokens como credenciales y guárdalos con permisos restrictivos.
• Revisa el plan con --dry antes de copiar.
• Mantén fuera --delete1 y --delete1emptyfolders para conservar el origen.
• Valida carpetas, mensajes y adjuntos antes de dar por terminada la migración.

📚 Fuentes consultadas

1. Imapsync — documentación y opciones de línea de comandos
2. OAuth 2.0 mechanism — Gmail — Google for Developers
3. Authenticate an IMAP, POP or SMTP connection using OAuth — Microsoft Learn

Imagen