Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

imap-migrate

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
7.5 Club score Visit github.com

What imap-migrate is

imap-migrate is a free, open-source command-line tool for moving email between IMAP hosts. It supports providers that offer IMAP access, with Gmail, Outlook, Fastmail, Yahoo, and custom servers among the examples. During migration it preserves original received dates and flags such as Seen and Flagged. The tool displays progress, transfer speed, success and error counts, and estimated time remaining; it also records actions in migration.log. The README says an interrupted migration can be rerun without creating duplicate emails. Its --dry-run option checks the connection and settings without transferring messages. Credentials can be provided as command-line arguments or environment variables, with environment variables recommended in the README as the more secure option. The tool requires Python 3.12 or higher and IMAP access enabled on both accounts; uv is suggested for dependency management. It runs on Linux, macOS, and Windows under the MIT License. Its scope is limited to transferring the contents of one folder: it does not recreate a full folder structure or move provider-specific features such as Gmail labels or categories.

Who it suits

imap-migrate suits users comfortable with command-line tools who need to move a folder between IMAP-enabled accounts. It is a free option for migrations where preserving dates and message flags matters.

Good to know, and what to watch

  • Preserves received dates and message flags.
  • Dry run checks settings without moving messages.
  • Reruns can avoid duplicate emails after interruption.
  • Shows progress, speed, counts, and estimated time remaining.
  • Available for Linux, macOS, and Windows.
  • Requires Python 3.12 or higher.
  • Both accounts need IMAP access enabled.
  • Moves one folder’s contents, not full folder structures.
  • Does not migrate provider-specific features such as Gmail labels.

Free

Free

Free plan

The verdict

imap-migrate focuses on straightforward IMAP folder transfers, with progress details and a dry-run option. Its one-folder scope and Python requirement are important constraints for planning a migration.

What the maker publishes

Credentials
Credentials can be supplied as command-line arguments or environment variables. source
Dry run
The --dry-run option tests the connection and settings without migrating emails. source
License
The project is licensed under the MIT License. source
Limitations
It migrates the contents of one folder to another and does not recreate the full folder structure or migrate provider-specific features such as Gmail labels or categories. source
Maintainer
The GitHub profile identifies cpluss as Sebastian Lund and lists London as the location. source
Metadata
It preserves original email received dates and flags such as Seen and Flagged. source
Platforms
Installation instructions show macOS and Linux, Windows, and pip as installation options. source
Progress and logs
It displays migration progress, speed, success and error counts, and estimated time remaining, and logs actions to migration.log. source
Provider support
It supports migration between providers with IMAP access, with Gmail, Outlook, Fastmail, Yahoo, and custom servers listed as examples. source
Purpose
imap-migrate is an open-source command-line tool for moving email from one IMAP host to another. source
Requirements
The tool requires Python 3.12 or higher and IMAP access enabled on both email accounts; uv is recommended for dependency management. source
Reruns
The README says interrupted migrations can be rerun without creating duplicate emails. source
Security
The README recommends environment variables for credentials as a more secure option; it does not state security certifications or compliance claims. source
Support
The project invites users to report bugs by opening a GitHub issue and welcomes contributions through pull requests. source

Checked against the maker's pages on 4 Oct 2026.