Home

IMAP Migration Tools

IMAP Migration Tools provides resumable command-line utilities for migrating, backing up, restoring, counting, and comparing email on IMAP servers. It supports password and OAuth2 authentication, Gmail labels, standard IMAP flags, local .eml backups, and destination synchronization.

The optional beta imap-tools terminal interface brings all five workflows into one responsive workspace with guided configuration, readiness hints, live output, cancellation, and local run history.

These tools can copy and delete email. Test with non-critical data, verify counts and backups, and review destructive options before using them on an important account.

Start here

• Installation — install the CLI, TUI, and optional Linux keyring support
• Configuration — configure accounts, precedence, paths, and shared options
• OAuth2 — register and configure Microsoft or Google applications
• Workflows — follow safe examples for count, backup, migrate, restore, and compare
• Terminal Interface — use the beta full-screen TUI
• Troubleshooting — diagnose authentication, IMAP, and migration problems
• Development — set up a source checkout and run project checks

Commands

Command	Purpose
imap-migrate	Copy or move email between IMAP accounts
imap-backup	Download an IMAP account as .eml files
imap-restore	Upload a local backup to an IMAP account
imap-compare	Compare folder counts across IMAP or local sources
imap-count	Count messages on an account or local backup
imap-tools	Configure and run all tools in the beta terminal interface

Project source and issue tracking remain in the main repository.