Migrate Yahoo Mail to iCloud: Complete IMAP Guide

You decided to consolidate your mail on iCloud and now you need to move years of Yahoo into it without losing folder structure, calendar invites, or your sanity. The path is real but it has two specific potholes most generic IMAP guides skip: Yahoo's app-password gate and iCloud's tight quota plus its picky IMAP behaviour around nested folders. This guide walks the working sequence and flags the failure modes that send people back to square one at 3am.

Why a direct IMAP-to-IMAP transfer is the right shape#

Yahoo Mail and iCloud Mail both speak standard IMAP, which means you don't need a paid migration appliance and you don't need to involve either vendor's support team. What you do need is a tool that can read from one IMAP server, write to another, preserve INTERNALDATE and flags, and handle the rate-limiting both providers apply at the connection level.

iCloud Mail in particular dislikes parallel connections from the same source IP. Yahoo, on the other hand, will silently degrade your FETCH throughput if you open more than two or three concurrent sessions. A sensible transfer engine respects both ceilings rather than fighting them.

Some Yahoo accounts inherited from the AT&T/SBC era have additional restrictions; if your address ends in @sbcglobal.net, @att.net, @ameritech.net, @bellsouth.net, @flash.net, @nvbell.net, @pacbell.net, @prodigy.net, @snet.net, or @swbell.net, the migration steps below still apply but the app-password screen lives at a different URL — sign in to Yahoo first, then navigate to Account Security to find it.

What you'll need before you start#

Set these aside before you launch anything:

• Your Yahoo address and an active Yahoo app password
• Your full Apple ID address and an Apple ID app-specific password
• Confirmation that iCloud Mail is enabled in your Apple ID (not all Apple IDs have iCloud Mail provisioned — accounts created before 2008 without an @me.com or @mac.com alias sometimes need to enable it via the iCloud system preferences)
• An estimate of your Yahoo mailbox size — use the size column in Yahoo's settings or sum your folder sizes in any desktop client connected to Yahoo
• A clear iCloud quota number with enough headroom

Step 1: Generate a Yahoo app password#

Yahoo no longer accepts your account password for IMAP. You need an app-specific password.

1. Sign in to Yahoo Mail in a browser
2. Click your profile circle and open Account Info
3. Choose Account Security in the left navigation
4. Scroll to "App password" and click Generate
5. Label it Mailbox Taxi migration so it's easy to revoke later
6. Copy the 16-character string — Yahoo will not show it again

If you don't see the app password option, Two-Step Verification is probably off. Turn it on (Account Security shows the toggle), wait a minute for Yahoo's settings to propagate, then the App Password generator appears. For deeper background on how app passwords work and which providers require them, see our app-specific password reference.

Step 2: Generate an Apple ID app-specific password#

This is the half people miss. iCloud's IMAP listener (imap.mail.me.com on port 993) will reject your Apple ID password even if 2FA is disabled. You always need an app-specific password for IMAP.

1. Sign in at appleid.apple.com
2. Open Sign-In and Security
3. Click App-Specific Passwords
4. Click the plus to generate a new one
5. Name it Mailbox Taxi
6. Apple may prompt you to confirm your Apple ID password — do that, then copy the new app-specific password (it looks like abcd-efgh-ijkl-mnop)

You can have up to 25 active app-specific passwords on a single Apple ID. If you've hit that ceiling, revoke an old unused one before generating the new one.

Step 3: Audit and right-size the source mailbox#

Now is the moment to throw away mail you'll never read again. iCloud quota is expensive past the free tier, and transferring 4GB of newsletter sludge from 2012 just to delete it on the other side wastes hours.

In Yahoo Mail itself, sort by size in the All Mail view, delete anything over 10MB you no longer need, empty the Trash, and empty the Spam folder. Then check your final size. The number Yahoo reports in account settings lags by up to an hour — wait it out before deciding on iCloud tier.

Also list out your folder structure. Make a note of any folder nested more than two levels deep, because iCloud's IMAP server flattens deep hierarchies on CREATE and you'll want to know which folders ended up where.

Step 4: Configure the transfer#

The Mailbox Taxi configuration screen needs four core values per side. Source first:

• Server: imap.mail.yahoo.com
• Port: 993
• Username: your full Yahoo email address
• Password: the Yahoo app password from Step 1

Destination:

• Server: imap.mail.me.com
• Port: 993
• Username: your full Apple ID email address (the @icloud.com, @me.com, or @mac.com address — not an alias)
• Password: the Apple ID app-specific password from Step 2

Connection limits worth setting on this pair: source concurrency 2, destination concurrency 1. iCloud will start refusing connections beyond two simultaneous from the same IP and the failure messages aren't always clean — sometimes you'll see Too many simultaneous connections, other times the session just hangs without a clean disconnect.

Step 5: Pilot one folder#

Pick a folder with 200–500 messages and run that first. The Inbox is a bad pilot because it churns during the migration. Pick Sent or a static archive folder.

What you're checking on the pilot:

• Message count matches on both sides
• INTERNALDATE carried over (sort by date received on iCloud, confirm chronological order)
• Read/unread flags preserved
• No Folder UTF-7 conversion error in the log — iCloud is strict on folder names with special characters
• Attachments open from iCloud Web (not just the desktop Mail app — the desktop client caches, which can mask a problem)

If anything looks off, fix it on the pilot rather than discovering it after 40GB has moved. The most common pilot issue is a folder with a slash in its name; Yahoo allows it as a literal character, iCloud uses / as its hierarchy separator. Rename the source folder in Yahoo to use an underscore or dash before migrating.

Step 6: Run the full transfer#

With the pilot clean, queue the full mailbox. Realistic expectations:

• Throughput: 200–500MB per hour on this pair
• 10GB mailbox: roughly 2–4 hours
• 25GB mailbox: roughly 6–12 hours, often run overnight
• Yahoo and iCloud both pause for a minute or two periodically — that's normal throttling

Don't sleep your laptop mid-run. The IMAP sessions will drop, both sides will return errors, and resume from a clean checkpoint is easier if you avoid the interruption in the first place. If you must use a laptop, plug it in and disable display sleep through the OS, not just the lid.

Step 7: Verify#

Once the run completes, check three things:

1. Folder counts side by side. Yahoo's count is authoritative; iCloud should match within a small margin (deleted-but-not-purged messages sometimes show differently).
2. Spot-check old messages — pick three at random from each year of your archive and confirm content, attachments, and senders are intact.
3. Test that new mail arriving at Yahoo still gets forwarded (if you set up forwarding) or that you've redirected senders to your iCloud address.

Common failure modes and what they actually mean#

AUTHENTICATIONFAILED on the iCloud side almost always means you used your Apple ID password instead of the app-specific password. Regenerate the app-specific password and try again.

Too many simultaneous connections on iCloud means your destination concurrency is too high. Drop to 1 and the rest of the queue will continue.

Over quota returned by iCloud during append is what it sounds like. Stop the run, upgrade iCloud+, then resume — Mailbox Taxi will skip already-migrated messages on resume.

STARTTLS handshake failed on either side usually means an old client library or an outbound firewall stripping TLS. Move the migration off corporate Wi-Fi if you're on one and try again.

Yahoo returning LIMIT_EXCEEDED or simply not responding to FETCH for minutes at a time is normal — Yahoo's IMAP throttles aggressively and Mailbox Taxi will back off and retry automatically. If it goes on for more than 10 minutes, pause the transfer, wait 30 minutes, and restart.

After the migration#

Once iCloud has the canonical copy:

• Set up forwarding from Yahoo to iCloud (Yahoo Settings, More Settings, Mailboxes, Forwarding)
• Update your address in any account that still mails the Yahoo address — banks, government services, employers
• Don't delete the Yahoo account for at least 90 days; some services use the address as a recovery contact and you'll want time to discover them
• If you migrated a calendar archive, that's a separate exercise — iCloud Calendar uses CalDAV, not IMAP, and Yahoo Calendar's export-to-ICS is the usual route

If you're consolidating away from Yahoo and iCloud isn't your final stop after all, our guides for moving Yahoo to Gmail and moving Yahoo to Outlook cover those pairs in similar detail. And if you later want to go the other direction, iCloud to Gmail follows the same template with different gotchas.

For the broader operational picture across any provider pair, the complete email migration guide walks through DNS, MX records, testing, and cutover strategy beyond just the IMAP transfer.