Email (IMAP/SMTP) Setup Guide

Connect any IMAP/SMTP email account to Oskuo. Use this connector for Fastmail, ProtonMail Bridge, Zoho Mail, self-hosted mail servers, and other providers. For Gmail, Google Workspace, and Outlook, dedicated connectors are available.

Prerequisites

check_circle Your email provider's IMAP and SMTP server addresses and ports (see common settings below)
check_circle An app-specific password from your email provider (never use your main password)
check_circle For Gmail, use the dedicated Gmail connector instead. For Outlook, use IMAP with an app password.
check_circle An active Oskuo account on any plan

Connecting Email to Oskuo

1 Find your IMAP and SMTP server settings from your email provider's documentation. Common settings: Gmail uses imap.gmail.com:993 / smtp.gmail.com:465, Outlook uses outlook.office365.com:993 / smtp.office365.com:587, Fastmail uses imap.fastmail.com:993 / smtp.fastmail.com:587.
2 Generate an app-specific password from your email provider's security settings. Never use your main account password.
3 Open Settings → Connectors in Oskuo and find the Email connector. Click Add instance.
4 Fill in all fields: account name, email address, full name (used as the sender name), IMAP host and port, SMTP host and port, username, and app password. The default SSL settings and ports work for most providers.
5 Click Test & Save. Oskuo will verify both the IMAP and SMTP connections.

What you can do

check_circle List emails with filters (folder, sender, date, read/unread)
check_circle Read the full content of an email message
check_circle Send new emails on your behalf
check_circle Search emails by keyword
check_circle Delete emails (move to Trash)

Try it out

Here are some things you can ask Oskuo to do:

chat_bubble "Show unread emails from today"
chat_bubble "Send an email to jane@example.com about the project"
chat_bubble "Search for emails about invoices"
chat_bubble "Read that last email from James and give me a quick summary"

Good to know

info Managing folders, server-side rules, and mail filters is not supported yet.
info This connector does not include calendar or contacts access — it handles email only.
info Encrypted emails (S/MIME or PGP) cannot be read through this connector.
info You can connect multiple email accounts as separate instances — handy if you have work and personal addresses.

Keeping things secure

lock Your email credentials are encrypted with AES-256-GCM and stored securely. They are never visible to other team members or Oskuo staff.
lock Always use an app-specific password — never your main account password. This limits the risk if a credential is ever compromised.
lock Ensure SSL is enabled for both IMAP and SMTP connections. The default settings use encrypted connections.
lock All email activity is logged in your team's audit trail, so you always have a record of what was accessed or sent.
lock You can connect multiple accounts as separate instances. Each has its own encrypted credentials.

Troubleshooting

IMAP connection failed expand_more

Check that the IMAP host is correct and the port is 993 (SSL). Some providers also support port 143 with STARTTLS. Ensure IMAP access is enabled in your email account settings — some providers disable it by default.

SMTP connection failed expand_more

Check the SMTP host and port. Most providers use port 465 (SSL) or 587 (STARTTLS). If one doesn't work, try the other.

Authentication failed expand_more

You likely need an app-specific password rather than your main password. If your provider uses two-factor authentication, generate an app password from your account security settings and use that instead.

Sent messages not appearing in Sent folder expand_more

Check that the "Save to Sent" option is enabled in the connector settings and that the Sent folder name matches your provider's convention (e.g. "Sent", "Sent Items", "Sent Messages").

External resources

Refer to your email provider's help documentation for IMAP/SMTP server details and app password setup instructions.

arrow_back Back to all connectors