Docs / Skills / Email

Email skill

Connect one or more mailboxes and let CloudyBot read, search, draft, send, and triage your email—all in plain language. The email skill supports Gmail, Outlook (Microsoft 365), and any standard IMAP/SMTP account.

How to connect a mailbox

1. Open the dashboard and go to Settings → Connect.
2. Under the Email section, choose your provider — Gmail, Outlook, or IMAP.
3. Gmail / Outlook — click Connect Gmail or Connect Outlook and complete the OAuth flow in the pop-up. Your tokens are encrypted and stored only for your account.
4. IMAP — enter your IMAP host, port, username, password, and SMTP details, then click Save & Connect. A live connection test runs before anything is stored.
5. Once linked you'll see the mailbox listed with a Default ✓ badge. You can connect additional mailboxes and switch the default at any time.
6. In the Specialists tab, open a specialist's settings and pick a Default mailbox under the Skills section. That specialist will always use that mailbox unless you explicitly name a different one in your message.

What you can ask

Copy a line and swap names or details for your own inbox.

• "Show me my last 20 unread emails and group them into: needs reply, FYI, can ignore."
• "Search for any email with 'invoice' in the subject from the last 30 days and list the sender and amount."
• "Draft a polite reply to the most recent email from {name} saying I'll get back to them by Friday."
• "Send a quick update to {address} with the subject 'Status update' and a two-sentence summary of today's progress."
• "Mark all emails from {sender} as read."
• "Every weekday at 8 am, give me a digest of overnight emails grouped by sender and priority."
• "Using my work mailbox, reply to the invoice thread — approve it and CC {manager}." (multi-mailbox: say which account)
• "Open the latest email from {sender}, save all attachments to my workspace under email-attachments, and summarize the PDF."
• "Save attachment index 0 from message {message_id} as invoice.pdf in ~/files/invoices/."

Save attachments to your workspace

When an email has files attached, CloudyBot can download them into your file workspace (~/files/...) so you can edit, share, or run other skills on them. Use email_get first to see attachment names and sizes, then ask to save one or all.

• Default folder: ~/files/email-attachments/ (you can specify another folder).
• Saved files count toward your plan's workspace storage limits.
• Outlook cloud-link or embedded-message attachments may be skipped with a clear reason.

Multiple mailboxes

You can connect as many mailboxes as you like — one per provider or multiple Gmail accounts. CloudyBot resolves which mailbox to use in this order:

1. Explicit — you name the mailbox in your message (e.g. "using my work email…").
2. Specialist default — the mailbox pinned to the specialist handling the conversation.
3. User default — the mailbox marked as default in Settings.

To rename a mailbox (e.g. "Work" or "Personal"), open Settings → Connect → Email and click Edit label.

Things to keep in mind

• Review before sending. Drafts are shown to you first; sent messages go immediately when you say "send".
• Gmail OAuth scope. CloudyBot requests the minimum Gmail scope needed to read, search, and send on your behalf. You can revoke access in your Google account security settings at any time.
• Outlook MFA / org policies. Corporate tenants may require IT approval before OAuth succeeds. Personal Microsoft accounts (Outlook.com) usually work straight away.
• IMAP app passwords. If your provider requires two-factor authentication, generate an app-specific password and use that — not your main account password.
• Send limits. The dashboard shows sends remaining today to help you stay within your plan's daily email limit.

FAQ

See also

Outlook (Microsoft 365) skill · Postmaster specialist · Integrations hub · All skills