Airmail Not Working After macOS Update — Troubleshooting Guide

<h2>Problem</h2><p>After updating macOS (e.g., from Sonoma to Sequoia, or a minor update), Airmail stops working, won't open, crashes, or can't connect to your email accounts.</p><h2>Solution</h2><h3>Step 1: Update Airmail</h3><p>After a macOS update, always check for an Airmail update too:</p><ol><li>Open the <strong>App Store</strong></li><li>Go to <strong>Updates</strong></li><li>Install any available Airmail update</li></ol><h3>Step 2: Grant Permissions</h3><p>macOS updates can reset app permissions:</p><ol><li>Go to <strong>System Settings → Privacy & Security</strong></li><li>Check and enable permissions for Airmail under:<ul><li>Files and Folders</li><li>Full Disk Access (if needed)</li><li>Contacts</li><li>Calendars</li><li>Notifications</li></ul></li></ol><h3>Step 3: Re-authenticate Accounts</h3><p>Some macOS updates reset OAuth tokens:</p><ol><li>Go to Airmail <strong>Settings → Accounts</strong></li><li>If any account shows an error, click on it</li><li>Re-enter your credentials or re-authenticate with your email provider</li></ol><h3>Step 4: Reset Airmail Cache</h3><ol><li>Quit Airmail (Cmd+Q)</li><li>Reopen Airmail while holding the <strong>Option</strong> key</li><li>You may see an option to reset or rebuild the database</li></ol><h3>Step 5: Reinstall</h3><p>If nothing else works:</p><ol><li>Delete Airmail from Applications</li><li>Reinstall from the App Store</li><li>Re-add your accounts</li></ol><p><strong>Note:</strong> Your email is safe on the server — reinstalling Airmail doesn't delete your emails.</p>

Updated on: 03/28/2026