shipmail

Mailbox import

Bring your old email along when you move to shipmail. The import copies your messages in the background while you keep working, preserves your folder structure, read state, and original dates, and skips duplicates so running it again is always safe.

Last updated

Supported sources

  • Gmail, Yahoo, AOL, iCloud, Fastmail, Zoho, and any IMAP provider: connect with an app password. The wizard walks you through creating one for each provider.
  • Outlook.com and Microsoft 365: click Sign in with Microsoft. Microsoft no longer supports app passwords for mail, so this is the only way to connect, and it also imports your Outlook contacts.
  • File uploads: Google Takeout archives (.mbox, including split and gzipped exports), Proton Mail Export Tool output, Tuta exports, and generic MBOX or EML zip files from Thunderbird or Apple Mail. Files can be up to 4 GB each.
  • Contacts: upload a .vcf (vCard) file from any provider during the import, or let the Microsoft sign-in bring Outlook contacts automatically.

Starting an import

  1. Go to the Mailboxes page and choose Import mail on the mailbox you want to fill. New mailboxes also offer the import right after creation.
  2. Pick your old provider and connect. The wizard checks the connection and shows your folders with message counts before anything starts.
  3. Choose what to import: folders, a time range (everything, or the last 12, 3, or 1 months), and whether spam and trash come along. They are skipped by default.
  4. Start the import and close the page. Mail shows up in your inbox as it imports, and you get an email with a per-folder report when everything is done.

Gmail specifics

Gmail labels become shipmail folders. A message with several labels shows up in each of those folders but is stored only once, with no duplicates. Google limits IMAP downloads to about 2.5 GB per day, so a large mailbox imports over several days. shipmail paces the transfer automatically, pauses when Google's daily limit is reached, and resumes on its own. The progress card always shows what is happening and why.

Safety and credentials

  • Your old account's password is encrypted, used only for this import, and deleted the moment the import finishes, fails, or is cancelled.
  • Imports are deduplicated by message identity. Running an import again only picks up new mail, which is the recommended way to catch stragglers before you close the old account.
  • Cancelling keeps everything imported so far. Messages larger than 50 MB are skipped and counted in the report.

Importing via the API

Everything above is also available programmatically: create imports, poll progress, and stage file uploads through the REST API, the TypeScript SDK, or the shipmail MCP server. See the mailboxes API reference for the endpoints.