Email Providers

Mailpilot works with any email provider that supports IMAP. This section covers setup guides for popular providers.

Supported Providers

Quick Configuration Examples

Gmail

accounts:
  - name: personal
    imap:
      host: imap.gmail.com
      port: 993
      username: ${GMAIL_USER}
      password: ${GMAIL_APP_PASSWORD}  # Not your regular password!

Outlook / Microsoft 365

accounts:
  - name: work
    imap:
      host: outlook.office365.com
      port: 993
      username: ${OUTLOOK_USER}
      password: ${OUTLOOK_PASSWORD}

Generic IMAP

accounts:
  - name: custom
    imap:
      host: imap.example.com
      port: 993
      username: ${EMAIL_USER}
      password: ${EMAIL_PASSWORD}
      tls: true

Common Requirements

Most email providers require:

1. IMAP enabled in account settings
2. App-specific password (not your regular password)
3. "Less secure apps" or OAuth disabled for IMAP access
4. TLS/SSL connection (port 993)

Testing Your Connection

After configuration, verify your IMAP connection:

1. Start Mailpilot: pnpm start
2. Check the dashboard at http://localhost:8080
3. Look for Health Status - IMAP should show as "Connected"
4. Check logs for connection errors

Troubleshooting

Authentication Failures

If you see "Authentication failed" errors:

• Gmail: Use an app password, not your regular password
• Outlook: Enable IMAP in account settings
• Yahoo: Generate an app password
• Others: Check if app passwords or OAuth is required

Connection Timeouts

If IMAP connections timeout:

• Verify the hostname and port are correct
• Check firewall rules allow outbound connections to port 993
• Try increasing the timeout setting in your configuration

SSL/TLS Errors

If you see SSL/TLS certificate errors:

imap:
  host: imap.example.com
  tls: true
  tls_options:
    rejectUnauthorized: false  # Only for self-signed certificates!

Provider-Specific Guides

Select your email provider for detailed setup instructions:

• Gmail Setup - Google Workspace and personal accounts
• Outlook Setup - Microsoft 365 and Outlook.com
• Yahoo Mail - Yahoo Mail configuration
• iCloud Mail - Apple iCloud setup
• ProtonMail - Using ProtonMail Bridge
• Generic IMAP - Any other IMAP server

Next Steps

After configuring your email provider:

1. Set up an LLM provider
2. Write classification rules
3. Test in the dashboard