IMAP Troubleshooting Guide: Fix Email Cleaner Not Working

Your email cleanup tool keeps failing. You see "connection refused," "authentication failed," or emails that won't delete. IMAP errors are common across Yahoo, GMX, Web.de, T-Online, iCloud, AOL, and Yandex. This guide walks through each error, explains why it happens, and gives step-by-step fixes—without compromising your privacy.

Why IMAP Cleanup Fails: Common Scenarios

IMAP is a protocol. When your email cleaner stops working, it's usually one of these problems.

Connection Refused or Timeout Errors

Your tool can't reach the provider's server. Causes include:

• Incorrect server address or port
• Provider blocking IMAP access
• Network firewall or VPN interference

Fix: Verify your IMAP server settings (see provider table below). Ensure IMAP is enabled in your account settings. Try disabling VPN temporarily.

Authentication Failures

"Wrong password" or "authentication failed" even though you typed correctly. This almost always means you're using your main password instead of an app password.

Fix: Generate an app-specific password for your cleanup tool. Never share your main account password.

"Folder Not Found" or "Mailbox Unavailable"

Your tool can't find standard folders like INBOX, Sent, or Trash. Some providers use non-standard folder names.

Fix: Check your provider's folder naming conventions. Yahoo uses "Inbox" (capital I). GMX may use "INBOX" (all caps).

Emails Appear Deleted but Reappear

You delete emails, but they come back after refresh. This happens when your tool moves emails to Trash but doesn't permanently delete them.

Fix: Enable "permanent delete" or "empty trash after deletion" in your cleanup tool. Some providers auto-purge Trash after 30 days.

Cleanup Tool Freezes or Crashes

Large batches can overwhelm the connection. Rate limits or security blocks may also cause timeouts.

Fix: Reduce batch size. Space out deletion sessions. Wait 15–60 minutes between attempts.

Provider-Specific Issues

Each provider has quirks.

Yahoo Mail IMAP Error

Yahoo is the most common source of IMAP errors. Key issues:

• App passwords required for third-party tools
• Folder naming: Uses "Inbox" (capital I), not "INBOX"
• Rate limits: Blocks repeated connections for 15–60 minutes

Fix: Generate an app password in Yahoo Security settings. Use server `imap.mail.yahoo.com`, port 993, SSL required. Wait if blocked.

GMX Connection Issue

GMX disables IMAP by default. Enable it manually.

• Server: `imap.gmx.net` (free) or `imap.gmx.com` (paid)
• Port: 993 with SSL
• Security: May flag repeated attempts as suspicious

Fix: Log into GMX webmail, go to Settings > IMAP, and enable it. Use the correct server address.

Web.de Security Blocks

Web.de aggressively blocks after multiple failed login attempts. This can lock your account for up to 24 hours.

• Server: `imap.web.de`
• Port: 993 with SSL
• App passwords: Required for third-party access

Fix: Generate an app password. Wait at least 30 minutes between attempts. Avoid retrying more than 3 times in an hour.

T-Online Legacy Settings

T-Online users often have outdated settings. New standards require updated server addresses.

• Server: `secureimap.t-online.de`
• Port: 993 with SSL
• Older accounts: May use `imap.t-online.de` (port 143, STARTTLS)

Fix: Use the secure server address. If that fails, try the legacy settings.

iCloud App-Specific Passwords

iCloud requires app-specific passwords when two-factor authentication is enabled.

• Server: `imap.mail.me.com`
• Port: 993 with SSL
• App password: Generate in Apple ID settings

Fix: Generate an app password at appleid.apple.com. Use that, not your iCloud password.

AOL Server Settings

AOL is similar to Yahoo but uses different server addresses.

• Server: `imap.aol.com`
• Port: 993 with SSL
• App passwords: Required

Fix: Generate an app password in AOL security settings. Use the correct server address.

Yandex Manual Enablement

Yandex requires you to enable IMAP manually and generates a separate app password.

• Server: `imap.yandex.com`
• Port: 993 with SSL
• Rate limits: Strict—max 250 connections per hour

Fix: Enable IMAP in Yandex webmail settings. Generate an app password. Limit cleanup sessions to avoid rate limits.

How to Fix App Password Problems

App passwords are the most common source of IMAP errors.

What App Passwords Are

App passwords are one-time-use codes generated by your provider. They grant limited access—email only—and can be revoked anytime. They are not your main password.

Why They're Required

Yahoo, GMX, Web.de, iCloud, AOL, and Yandex all require app passwords for third-party IMAP access. This is a security measure to protect your account.

Step-by-Step: Generate App Passwords

Yahoo: 1. Go to Yahoo Account Security 2. Click "Generate app password" 3. Select "Mail" and "Desktop" (or "Other app") 4. Copy the generated password

GMX / Web.de: 1. Log into webmail 2. Go to Settings > Security > App Passwords 3. Generate a new password for "IMAP" 4. Copy it

iCloud: 1. Go to appleid.apple.com 2. Sign in, go to Security > App-Specific Passwords 3. Generate one for "Mail" 4. Copy it

AOL: 1. Go to AOL Account Security 2. Click "Generate app password" 3. Copy it

Yandex: 1. Go to Yandex Passport 2. Go to Passwords and Authorization > App Passwords 3. Generate for "IMAP" 4. Copy it

Common Mistakes

• Using your main password: Never do this. It gives full account access.
• Expired passwords: Some app passwords expire after 6 months. Generate a new one.
• Copying incorrectly: Paste the password directly into your cleanup tool.

How Klearbox Handles App Passwords

Klearbox uses your app password for the connection only. It is not stored, not saved, and not accessible after the session ends. Your email content is never read or stored. This is part of Klearbox's privacy-first architecture.

Correct IMAP Server Settings for Each Provider

Only incoming IMAP settings are needed for cleanup. Outgoing (SMTP) settings are irrelevant.

Provider	Server Address	Port	SSL/TLS
Yahoo Mail	`imap.mail.yahoo.com`	993	SSL required
GMX (free)	`imap.gmx.net`	993	SSL required
GMX (paid)	`imap.gmx.com`	993	SSL required
Web.de	`imap.web.de`	993	SSL required
T-Online	`secureimap.t-online.de`	993	SSL required
iCloud	`imap.mail.me.com`	993	SSL required
AOL	`imap.aol.com`	993	SSL required
Yandex	`imap.yandex.com`	993	SSL required

How to Verify Settings Before Connecting

1. Open your cleanup tool's connection settings 2. Enter the server address and port exactly as shown 3. Select SSL/TLS (not STARTTLS) 4. Enter your full email address as username 5. Enter your app password (not main password) 6. Test the connection with a single email first

Dealing with Rate Limits and Security Blocks

Providers block repeated IMAP connections to prevent abuse. This is normal and expected.

Why Blocks Happen

• Too many connection attempts in a short time
• Multiple failed login attempts
• Suspicious activity (e.g., bulk deletion from a new location)

How Long Blocks Last

• Yahoo: 15–60 minutes
• GMX / Web.de: 30 minutes to 24 hours
• iCloud: 15–30 minutes
• Yandex: 1 hour (after exceeding 250 connections/hour)

Best Practices

• Batch deletions: Delete 500–1000 emails per session, not 10,000
• Space out connections: Wait at least 15 minutes between sessions
• Use preview mode: Confirm your selection before bulk deleting
• Avoid peak hours: Providers are more sensitive during high-traffic periods

Klearbox's Approach

Klearbox uses controlled, non-aggressive IMAP usage. It respects provider rate limits and pauses automatically when needed. Live progress tracking shows you exactly where cleanup stands.

What to Do If Emails Aren't Deleted or Moved

Sometimes emails appear deleted but don't actually go away.

Check Trash Folder Behavior

Some providers move emails to Trash instead of permanently deleting. Check your cleanup tool's settings for "permanent delete" or "empty trash after deletion."

Verify Folder Permissions

Your account may have read-only access to certain folders. Test with a single email first. If it fails, check your provider's folder permissions.

Test with a Single Email

Before bulk deleting, delete one email manually. If it works, proceed. If not, check your settings.

Use Preview Mode

Klearbox offers preview-based deletion. You see exactly which emails will be deleted before confirming. This prevents accidental deletions and confirms your filters are correct.

When to Contact Support (and What Info to Provide)

If you've tried everything and cleanup still fails, contact support.

What to Include

• Error message screenshot: Exact text of the error
• Provider name and account type: Free or paid
• Steps already attempted: App password, server settings, rate limit wait
• Tool name and version: If using Klearbox, mention that

Klearbox Support

Klearbox support responds within 24 hours. Include your account email and a brief description of the issue. They can verify your connection settings without accessing your account.

Privacy Considerations During Troubleshooting

Troubleshooting should never compromise your security.

Never Share Your Main Password

No legitimate tool asks for your main password. If it does, stop immediately.

App Passwords Limit Access

App passwords grant email-only access. They cannot change account settings, reset passwords, or access other services.

Klearbox Doesn't Store or Read Your Emails

Klearbox uses IMAP connections without saving your email content. Your data stays on the provider's servers. Klearbox only sees metadata needed for cleanup (sender, subject, date).

EU Hosting and GDPR Compliance

Klearbox is hosted in the EU and fully GDPR-compliant. Your data never leaves European jurisdiction.

What to Do If You Suspect a Security Breach

1. Change your main password immediately 2. Revoke all app passwords 3. Enable two-factor authentication 4. Contact your provider's support 5. Run a security scan on your device

FAQ

Why does my email cleaner say "connection refused"?

Incorrect server settings or provider blocking. Check your IMAP server address and port, then verify your provider allows IMAP access.

Do I need an app password for Yahoo Mail?

Yes. Yahoo requires app-specific passwords for third-party IMAP access. Generate one in your Yahoo account security settings.

Why do my deleted emails keep coming back?

Some providers move emails to Trash instead of permanently deleting. Check your cleanup tool's settings for "permanent delete" or "empty trash after deletion."

How long does a provider block last after too many IMAP attempts?

Typically 15 minutes to 24 hours. Wait before retrying, and consider spacing out your cleanup sessions.

Is it safe to enter my IMAP settings into a cleanup tool?

Only if the tool doesn't store your credentials or email content. Klearbox uses IMAP connections without saving your data, and is hosted in the EU under GDPR.

What if my provider doesn't support IMAP?

Klearbox only works with IMAP-supported providers. Check your provider's help documentation or consider switching to one that supports IMAP.

Can I use Klearbox without an app password?

For most providers, no. App passwords are required for third-party IMAP access. Klearbox walks you through generating one.

Ready to clean your inbox? uses IMAP connections without storing your data. EU-hosted, GDPR-compliant, and privacy-first.

Klearbox