Skip to main content

Adding Accounts

Gaivota supports Microsoft and Gmail accounts. You can add multiple accounts and switch between them seamlessly.

Adding a Microsoft Account​

Microsoft accounts include Outlook.com, Hotmail, Microsoft 365, and work/school accounts.

  1. Click Add Account or go to Settings → Accounts
  2. Select Microsoft
  3. A browser window will open for authentication
  4. Sign in with your Microsoft credentials
  5. Grant Gaivota permission to access your email
  6. You'll be redirected back to Gaivota

Once connected, Gaivota will begin syncing your folders and emails. The initial sync may take a few minutes depending on your mailbox size.

Adding a Gmail Account​

Gmail accounts include personal Gmail and Google Workspace accounts.

  1. Click Add Account or go to Settings → Accounts
  2. Select Gmail
  3. A browser window will open for Google authentication
  4. Sign in with your Google credentials
  5. Grant Gaivota permission to access your email
  6. You'll be redirected back to Gaivota
info

Gmail uses OAuth 2.0 for secure authentication. Gaivota never sees or stores your password.

Managing Multiple Accounts​

You can add multiple email accounts to Gaivota. Each account appears in the sidebar with its own folder tree.

Switching Between Accounts​

Use keyboard shortcuts to quickly switch accounts:

ShortcutAction
1Switch to first account
2Switch to second account
3 - 9Switch to accounts 3-9

Or click on an account in the sidebar to switch to it.

Account Settings​

Each account has individual settings you can customize:

  1. Go to Settings (⌘,) → Accounts
  2. Click on the account you want to configure
  3. Available settings:
    • Display Name: How the account appears in the sidebar
    • From Name: The name shown when you send emails

Removing an Account​

To remove an account:

  1. Go to Settings → Accounts
  2. Find the account you want to remove
  3. Click the Remove button
  4. Confirm the removal
warning

Removing an account will delete all locally cached data for that account. Your emails on the server are not affected.

Troubleshooting​

Authentication Failed​

If authentication fails:

  • Ensure you're using the correct credentials
  • Check that your account doesn't have two-factor authentication issues
  • For work/school accounts, your organization may have restrictions

Sync Issues​

If emails aren't syncing:

  • Check your internet connection
  • Try removing and re-adding the account
  • Check the account status in Settings

Permission Denied​

If Gaivota can't access your email:

  • You may have denied permissions during sign-in
  • Remove the account and add it again
  • Make sure to grant all requested permissions