Exportar correos de Gmail a Excel o Google Sheets: una fila por correo, sola cada hora, con Apps Script
Lo esencial
- Un programa de Apps Script busca en tu Gmail lo que tú le digas (por ejemplo, `label:facturas newer_than:30d`) y copia cada correo en una fila: fecha, remitente, asunto, un extracto y cuántos adjuntos trae.
- No repite: guarda el identificador de cada correo y se salta los que ya copió. Un disparador lo ejecuta cada hora.
- Empieza en modo de ensayo: no toca la hoja, solo escribe en el registro cuántos correos copiaría.
- Para tenerlo en Excel: en la hoja, Archivo > Descargar > Microsoft Excel (.xlsx).
- Gratis con una cuenta de Google. Ojo: el permiso de Gmail que pide es amplio. Nivel principiante, unos 20 minutos. Probado con una simulación; nadie lo ejecutó aún en una cuenta real.
Las facturas que llegan por correo, las respuestas de un formulario, los pedidos de una tienda: todo está en Gmail, pero para sumarlo o filtrarlo lo necesitas en una tabla, y copiarlo a mano es lo que se deja para mañana. Esta guía deja un programa corto de Apps Script que busca en tu Gmail lo que le pidas y copia cada correo en una fila de Google Sheets, solo y cada hora. Si lo necesitas en Excel, la hoja se descarga como archivo .xlsx.
Qué necesitas
- Una cuenta de Google con Gmail, y Google Sheets en el navegador del computador.
- Nivel: principiante. Vas a copiar un programa, cambiar una línea con tu búsqueda y autorizarlo una vez. No hace falta saber programar.
- Tiempo: unos 20 minutos la primera vez.
- Dinero: nada. Apps Script se usa con tu cuenta de Google, sin instalar nada. Tiene cuotas (leídas dos veces el 11 de noviembre de 2026): con una cuenta personal, 20.000 lecturas o escrituras de correo al día, 6 minutos por ejecución y 90 minutos al día de disparadores en total. Con una cuenta de Google Workspace los límites son mayores: están en la misma página.
- Un aviso sobre el permiso. Según la referencia de GmailApp (leída dos veces el 11 de noviembre de 2026), buscar y leer correos pide el permiso
https://mail.google.com/, que es el acceso completo a tu Gmail. El programa de esta guía solo lee, pero Google no sabe eso: te pedirá el permiso entero. Por eso, pega solo un programa que hayas leído, como este, y no le des ese permiso a uno que te pase un desconocido.
Cómo funciona
Tres piezas, las tres oficiales de Google:
- La búsqueda de Gmail. El programa usa
GmailApp.search, que según su referencia acepta la búsqueda “tal como la escribirías en Gmail”. Así que sirve todo lo que ya funciona en la caja de búsqueda: según la ayuda de Gmail (consultada el 11 de noviembre de 2026),from:para el remitente,subject:para el asunto,label:para una etiqueta,has:attachmentpara los que traen adjuntos ynewer_than:2dpara los de los últimos dos días. - La hoja. Cada correo nuevo es una fila. El identificador de cada correo, que da
getId(), se guarda en la última columna: así el programa sabe cuáles ya copió. - Un disparador de tiempo, que lo ejecuta cada hora aunque la hoja esté cerrada. Según la referencia del disparador,
everyHours(n)lo ejecuta cadanhoras.
Paso 1 · Prueba tu búsqueda en Gmail
Escribe la búsqueda en la caja de Gmail y mira qué sale. Si ahí salen los correos que quieres, el programa encontrará los mismos. Ejemplos:
| Quieres | Búsqueda |
|---|---|
| Las facturas que guardas con una etiqueta | label:facturas newer_than:30d |
| Lo que te envía un proveedor | from:pagos@ejemplo.com |
| Los correos con adjuntos de este mes | has:attachment newer_than:30d |
| Las respuestas de un formulario | subject:"Nueva respuesta" |
Empieza con algo acotado: unos días o una etiqueta.
Paso 2 · Prepara la hoja y pega el programa
- Crea una hoja de cálculo nueva y llama
Correosa la pestaña. Déjala vacía: el programa pone los encabezados. - Ve a Extensiones > Apps Script. Se abre el editor con un archivo
Código.gs. Borra lo que trae y pega esto:
// Copia en una hoja los correos de Gmail que cumplen una búsqueda:
// una fila por correo, sin repetir los que ya copió.
const HOJA = 'Correos'; // nombre de la pestaña
const BUSQUEDA = 'label:facturas newer_than:30d'; // como la escribirías en Gmail
const MAXIMO = 50; // conversaciones por ejecución
const LARGO_EXTRACTO = 200; // letras del cuerpo que se copian
const ENSAYO = true; // true: solo escribe en el registro
function copiarCorreos() {
const libro = SpreadsheetApp.getActiveSpreadsheet();
const hoja = libro.getSheetByName(HOJA);
if (!hoja) throw new Error('No hay ninguna pestaña llamada ' + HOJA);
if (hoja.getLastRow() === 0 && !ENSAYO) {
hoja.appendRow(['Fecha', 'De', 'Asunto', 'Extracto', 'Adjuntos', 'ID']);
}
// Los ID ya copiados están en la columna F: así no se repite ninguno.
// Llevan delante "id:" para que la hoja nunca los confunda con un número.
const copiados = new Set();
const ultima = hoja.getLastRow();
if (ultima > 1) {
hoja.getRange(2, 6, ultima - 1, 1).getValues()
.forEach(fila => copiados.add(String(fila[0])));
}
const nuevas = [];
const conversaciones = GmailApp.search(BUSQUEDA, 0, MAXIMO);
conversaciones.forEach(conversacion => {
conversacion.getMessages().forEach(correo => {
const id = 'id:' + correo.getId();
if (copiados.has(id)) return;
copiados.add(id);
const extracto = correo.getPlainBody().replace(/\s+/g, ' ').trim()
.slice(0, LARGO_EXTRACTO);
nuevas.push([
correo.getDate(),
texto(correo.getFrom()),
texto(correo.getSubject()),
texto(extracto),
correo.getAttachments({ includeInlineImages: false }).length,
id,
]);
});
});
nuevas.sort((a, b) => a[0] - b[0]); // de la más antigua a la más reciente
if (ENSAYO) {
console.log('ENSAYO. Copiaría ' + nuevas.length + ' correos nuevos.');
nuevas.slice(0, 5).forEach(f => console.log(' ' + f[1] + ' | ' + f[2]));
return;
}
if (nuevas.length === 0) return;
hoja.getRange(hoja.getLastRow() + 1, 1, nuevas.length, nuevas[0].length)
.setValues(nuevas);
console.log('Copiados ' + nuevas.length + ' correos nuevos.');
}
// Ejecuta esta una sola vez: deja el programa revisando el correo cada hora.
function instalarDisparador() {
ScriptApp.newTrigger('copiarCorreos').timeBased().everyHours(1).create();
}
// Un texto que empieza por =, +, - o @ podría tomarse como fórmula:
// con un apóstrofo delante, la hoja lo guarda como texto.
function texto(valor) {
const s = String(valor);
return /^[=+\-@]/.test(s) ? "'" + s : s;
}
- Cambia la línea de
BUSQUEDApor la tuya, entre comillas simples. Si tu búsqueda lleva comillas dobles, comosubject:"Nueva respuesta", déjalas: van dentro de las simples. - Guarda con el icono del disquete.
Paso 3 · Pruébalo en modo de ensayo
El programa empieza con ENSAYO = true: busca en Gmail y escribe en el registro cuántos correos copiaría, con el remitente y el asunto de los cinco primeros. No escribe nada en la hoja.
- En el menú de arriba del editor, elige la función
copiarCorreosy pulsa Ejecutar. - La primera vez, Google te pide autorizar el programa. Pedirá acceso a tu Gmail y a tus hojas de cálculo: el de Gmail es el permiso amplio del que habla “Qué necesitas”. Según la guía de permisos de Apps Script (leída el 11 de noviembre de 2026), la pantalla puede dejarte elegir qué permisos das; si no das el de Gmail, el programa fallará al buscar. Nadie ha visto todavía esa pantalla para esta guía (mira “Qué se comprobó”).
- Abajo, en el registro de ejecución, verás algo como
ENSAYO. Copiaría 12 correos nuevos.y las primeras líneas.
Paso 4 · Actívalo
- Cambia
const ENSAYO = true;porconst ENSAYO = false;y guarda. - Ejecuta
copiarCorreosuna vez a mano. La pestañaCorreosse llena: encabezados en la fila 1 y un correo por fila, del más antiguo al más reciente. - Elige la función
instalarDisparadory pulsa Ejecutar, una sola vez. Desde entonces, cada hora el programa copia lo nuevo. Si lo ejecutas dos veces, tendrás dos disparadores: no se duplican filas, pero gastas cuota. - Compruébalo: en el editor, a la izquierda, el icono del reloj (Triggers en la ayuda de Google, que está en inglés) lista los disparadores. Desde ahí también se borra.
Así queda la hoja:
| Fecha | De | Asunto | Extracto | Adjuntos | ID |
|---|---|---|---|---|---|
| 03/11/2026 10:00 | Proveedor pagos@ejemplo.com | Factura 118 | Hola, adjunto la factura 118… | 1 | id:… |
| 04/11/2026 09:00 | Tú yo@ejemplo.com | Re: Factura 118 | Recibida, gracias. | 0 | id:… |
Los datos de esta tabla son inventados: son los de la simulación con la que se probó el programa.
Paso 5 · Llévalo a Excel
La hoja sigue viva en Google Sheets. Cuando quieras una copia en Excel, según la ayuda de Documentos de Google (consultada el 11 de noviembre de 2026): Archivo > Descargar y elige Microsoft Excel (.xlsx). La copia es una foto de ese momento: los correos que lleguen después solo entran en la hoja de Google.
Qué hace el programa, paso a paso
- Abre la pestaña
Correos. Si está vacía, escribe los encabezados. - Lee la columna F, donde están los identificadores de los correos ya copiados.
- Busca en Gmail con tu
BUSQUEDAy toma las primeras 50 conversaciones que devuelve (MAXIMO). Recorre cada correo de cada una. - Se salta los que ya copió. De los nuevos toma la fecha, el remitente, el asunto, los primeros 200 caracteres del cuerpo (sin saltos de línea) y cuántos adjuntos trae.
- Ordena las filas nuevas por fecha y las escribe todas de una vez al final de la hoja.
Tres detalles:
- Copia la conversación entera. Gmail busca conversaciones, no correos sueltos: si una conversación cumple la búsqueda, entran también tus respuestas. Si solo quieres lo que te llega, añade
-from:mea la búsqueda. - Las imágenes de la firma no cuentan como adjuntos. Según la referencia del correo (leída el 11 de noviembre de 2026),
getAttachments()cuenta por defecto las imágenes insertadas, como el logo de una firma;includeInlineImages: falselas deja fuera. - Un asunto que empieza por
=se guarda como texto. Según la referencia de la hoja, un valor que empieza por=se interpreta como fórmula. Un correo podría traer en el asunto algo que la hoja ejecutaría; el programa le pone un apóstrofo delante (también si empieza por+,-o@).
Variaciones
Más o menos texto. LARGO_EXTRACTO es cuántos caracteres del cuerpo se copian. Con 0 no se copia ninguno, y la columna queda vacía.
Cada menos tiempo. En instalarDisparador, cambia everyHours(1) por everyMinutes(30). Según la referencia, los minutos solo pueden ser 1, 5, 10, 15 o 30. Más a menudo gasta más de los 90 minutos diarios de disparadores.
Qué se comprobó
- El programa se ejecutó el 11 de noviembre de 2026 contra una simulación escrita en Node.js, no en Google. Se probaron estos casos: el modo de ensayo (no escribe nada en la hoja y cuenta bien los correos), la primera copia de tres correos de dos conversaciones (encabezados, orden por fecha, extracto de 200 caracteres, número de adjuntos y fecha guardada como fecha), un asunto que empezaba por
=y un cuerpo que empezaba por-(quedaron como texto), una segunda ejecución (no repitió nada), una respuesta nueva en una conversación ya copiada (añadió solo esa), un identificador con forma de número (no se repitió), una pestaña con otro nombre (dio un error claro), una búsqueda sin resultados y la creación del disparador. Todos dieron lo esperado. La opciónincludeInlineImages: falsese añadió después, en la revisión del mismo día; la simulación no la cubre. La simulación no garantiza que Google se comporte igual en todo. - Nadie lo ha ejecutado todavía en una cuenta real, ni ha visto la pantalla de autorización. Los métodos que usa salen de la referencia oficial, leída ese día:
GmailApp.search,getMessagesy, de cada correo,getId,getDate,getFrom,getSubject,getPlainBodyygetAttachments. - Lo que la documentación no aclara: cuánto tarda una ejecución con muchos correos. Si pasa de los 6 minutos, se corta sin escribir nada, y la siguiente lo intentará igual: baja
MAXIMOo acota la búsqueda. Tampoco dice en qué orden devuelve las conversaciones; si tu búsqueda trae más de 50, las que queden fuera no se copian. Por eso conviene acotarla connewer_than:y copiar lo antiguo, si lo necesitas, con búsquedas por tramos (after:ybefore:).
Errores comunes
- “No hay ninguna pestaña llamada Correos”. El nombre tiene que coincidir letra por letra con
HOJA. - El ensayo dice 0 correos. La búsqueda no encuentra nada: pruébala tal cual en la caja de Gmail.
- Dejar el modo de ensayo puesto. Si la hoja no se llena y en las ejecuciones ves
ENSAYO. Copiaría…, no cambiasteENSAYOafalse. - Borrar la columna F. Es la memoria del programa: sin ella, vuelve a copiar todo. Si te estorba, ocúltala en lugar de borrarla.
- Compartir la hoja sin pensarlo. La hoja contiene trozos de tus correos: quien la vea, los lee.
- Si el programa falla, según la guía de disparadores Google te envía un correo con el resumen de los fallos, y en el editor, en Executions (Ejecuciones), ves cada ejecución con su error.
Para seguir
Si lo que quieres es que la hoja te avise a ti, mira cómo enviar correos automáticos desde Google Sheets, con el mismo editor. Para que el correo llegue ya ordenado a su etiqueta, y la búsqueda sea más fácil, empieza por los filtros de Gmail. Y con la tabla ya hecha, puedes analizar los datos con IA para sacar conclusiones que se pueden comprobar.