Frequently Asked Questions
General
What is MailCopilot?
MailCopilot is a modern desktop email client that connects to your existing email accounts via IMAP and SMTP protocols. It is built for speed, privacy, and simplicity.
Which platforms does MailCopilot support?
Currently, MailCopilot is available for Linux as an AppImage. Windows and macOS support is planned for future releases.
Is MailCopilot free?
Visit mailcopilot.io for the latest information about pricing and availability.
Where are my passwords stored?
Passwords are stored securely in your system's keychain (via keytar). They are never saved in plain-text configuration files.
Accounts
Which email providers are supported?
MailCopilot works with any provider that supports IMAP and SMTP, including Gmail, Outlook, Yahoo, Fastmail, Yandex Mail, Mail.ru, ProtonMail (via Bridge), and self-hosted servers.
How do I connect a Gmail account?
Click Sign in with Google in the account setup wizard. A browser window will open for authorization. No app password is needed.
Can I use multiple accounts?
Yes. Add as many accounts as you need. You can switch between them in the sidebar or use the Unified Inbox to see all messages in one place.
The connection test shows a TLS certificate error. What should I do?
MailCopilot always verifies TLS certificates. If your mail server uses a self-signed or custom certificate, a trust prompt will appear. Review the certificate details and choose to trust it if you are confident the server is legitimate.
Messages
How do I search for messages?
Click the search bar (or press /*) and type your query. MailCopilot searches message subjects, senders, and content.
Can I undo deleting a message?
Yes. After deleting, archiving, or marking a message as spam, an undo bar appears at the bottom of the screen. Click Undo before the countdown expires to reverse the action.
How does conversation threading work?
When enabled (the default), related messages are grouped into conversation threads based on their subject and references. You can disable this in Settings > Productivity > Group messages into conversations.
How do I move messages between folders?
You can drag and drop messages from the list to a folder in the sidebar, right-click and choose Move to folder, or press v to open the folder picker.
Compose
Where are my drafts saved?
Drafts are saved automatically in two places: locally in the application, and optionally to your IMAP Drafts folder on the server (if draft sync is enabled in settings).
Can I schedule messages to be sent later?
Yes. Click the Schedule button in the compose window and choose when to send. Scheduled messages appear in the Outbox folder where you can edit or cancel them.
What is the maximum attachment size?
The maximum size is 25 MB per file.
AI Assistant
Is the AI assistant required?
No. The AI assistant is entirely optional. If you do not configure it, no email data is sent to any AI service.
What data does the AI assistant access?
When you use the assistant, the content of the currently selected email (and optionally the thread) is sent to the AI provider (Anthropic). A privacy notice is shown before first use.
Which AI models are available?
You can choose between Claude Sonnet 4.5, Claude Opus 4.6, and Claude Haiku 4.5.
Troubleshooting
MailCopilot is not syncing new messages.
- Check that IMAP IDLE is enabled in Settings > Productivity.
- Try clicking the Sync button in the sidebar.
- Verify your internet connection.
- Check the account connection status in Settings > Accounts.
The application is slow or unresponsive.
Try reducing the Cache duration in Settings > General. If you have very large folders, consider using the By period header sync mode in Settings > Folders.
I cannot see some folders.
Some folders may be hidden. Right-click in the sidebar and look for hidden folder options, or go to Settings > Folders and check the Show in sidebar option for each folder.