Install
git clone https://github.com/fathomise/MailFathom.git
cd MailFathom
scripts/quick-start-compose.shPara quién es
MailFathom sincroniza varios buzones IMAP en una base de datos PostgreSQL que tú mismo operas, indexa esa copia y se la ofrece a la IA como herramientas MCP (Model Context Protocol). Encaja con:
- quienes quieren que la IA busque en su correo y responda preguntas de correo sin rastrear una y otra vez el webmail;
- personas o equipos pequeños que ya autoalojan y están dispuestos a operar por su cuenta la base y el proceso del servicio;
- usuarios que cuidan el perímetro de sus datos y quieren que la copia y el índice del correo queden solo en sus máquinas;
- quien tiene varios buzones IMAP y quiere que la IA los registre todos en un mismo sitio: varias cuentas se sincronizan en la misma base.
Requisitos previos y lo que no es:
- No es un servicio gestionado: PostgreSQL y el propio MailFathom los operas y mantienes tú, así que no encaja con quien no quiere administrar servidores;
- La evidencia solo cubre la sincronización de buzones IMAP; si admite otros protocolos de correo, calendarios o análisis profundo de adjuntos no está indicado, sin confirmar;
- Las escrituras — marcar, redactar borradores, enviar — están todas desactivadas por defecto, y cada cuenta y cada credencial debe autorizarse por separado antes de que algo se active. Si esperabas que, recién instalado, la IA toque el buzón, primero tienes que aceptar este flujo de autorización.
Una primera prueba en tres minutos
Solo hay un camino recomendado: clonar el repositorio oficial y ejecutar el script de inicio rápido.
git clone https://github.com/fathomise/MailFathom.git
cd MailFathom
scripts/quick-start-compose.sh
Condiciones: una máquina bajo tu control y aceptar que la copia del correo viva en el PostgreSQL que operas. Los puertos y variables de entorno que necesita el script no constan en la evidencia; lee el script antes de ejecutarlo. Después conecta el servicio a tu cliente de IA como MCP; la configuración concreta no aparece en la evidencia, rígete a la descripción del repositorio.
Para la primera llamada, prueba list_accounts: es una herramienta de lectura y no toca las acciones de escritura — marcar, redactar, enviar. La señal de éxito es que la IA devuelva la lista de cuentas sincronizadas. Para avanzar un paso, llama a search_emails con palabras clave; los resultados se ordenan léxicamente y, en cuanto configuras un modelo de embeddings, la similitud semántica también entra en el orden.
Todo lo leído procede de la copia sincronizada en la base; cada cuánto se sincroniza y cuánto se desfasa del buzón real no está indicado, sin confirmar.
Aviso: solo lectura no significa riesgo cero — las herramientas de lectura ven todo el contenido de correo sincronizado en la base; qué buzones entran en la copia y cómo se controla el alcance de la sincronización no están indicados, sin confirmar.
Casos de uso
Caso 1: recuperar un correo viejo por palabra clave. Escenario: recuerdas que un correo mencionaba cierta palabra y no quieres pasar el buzón página por página. Cómo hacerlo: pide a la IA que llame a search_emails con la palabra clave. Resultado esperable: una lista de coincidencias ordenada léxicamente (con similitud semántica tras configurar un modelo de embeddings); para el texto completo, get_email_content, que sirve hasta diez mensajes completos por llamada.
Caso 2: preguntar a través de varios correos. Escenario: preguntas del tipo «qué se dijo sobre este asunto antes y después», que exigen combinar varios mensajes. Cómo hacerlo: llama a ask_mail con una sola pregunta en lenguaje natural. Resultado esperable: una respuesta apoyada en tu correo sincronizado, citando uno a uno los mensajes que utilizó; hasta dónde llega depende del correo efectivamente sincronizado en la base.
Ambos casos usan solo lectura. Para marcar, redactar o enviar hay que activar antes el permiso de escritura correspondiente, cuenta por cuenta y credencial por credencial — es el diseño oficial, no una avería.
Límites de uso
- Naturaleza de lectura y escritura: las herramientas de lectura (
list_accounts,list_emails,search_emails,get_email_content,ask_mail) y las operaciones de escritura (marcar, redactar borradores, enviar) están estrictamente separadas; las capacidades de escritura están desactivadas por defecto y deben autorizarse cuenta por cuenta y credencial por credencial. Sobre qué actúa una escritura — si el buzón real o la copia local sincronizada — no hay indicación oficial, sin confirmar; que exista un camino para deshacer tampoco está confirmado. - Credenciales y datos: lo que se sincroniza son tus buzones IMAP; la copia y el índice viven en tu propio PostgreSQL; cómo se envían y almacenan las credenciales IMAP y si van cifradas no está indicado, sin confirmar.
- Límites de búsqueda y respuesta:
search_emailsordena léxicamente por defecto y la similitud semántica solo surte efecto tras configurar un modelo de embeddings; las respuestas y citas deask_mailse apoyan únicamente en el correo sincronizado: lo no sincronizado no se puede preguntar. - Efectos y puntos de confirmación: activar cada permiso de escritura es un punto de confirmación que conviene pensar bien — activa solo el que de verdad necesites; el efecto concreto de una escritura no consta en la evidencia, así que en la primera prueba deja los permisos de escritura apagados y quédate con las herramientas de lectura.
- Alcance de herramientas: oficialmente, veintiún herramientas son toda la superficie; más allá no hay evidencia que respalde capacidades, no cuentes con un «seguro que también vale».
- Información clave sin confirmar: dónde actúan las escrituras, cómo se almacenan las credenciales IMAP, vías de instalación distintas del script de inicio rápido, opciones de configuración y límites de rendimiento concretos, y frecuencia de sincronización no quedan cubiertos por la evidencia; el tipo de licencia es AGPL-3.0-only (así figura en el título de la fuente) y el texto completo no está incluido; remítete al repositorio oficial.