June logo
JuneDocumentation
Integrations

Mailbox (Gmail or IMAP)

June searches and reads your mail and writes drafts for you to send, in Gmail or any IMAP mailbox. From Gmail it also sends a message or a draft, only after you approve it.

Connect a mailbox and June can find a mail, read a thread and write a reply as a draft in your mailbox, ready for you to check and send. In Gmail it can also send the reply itself once you approve it. It works with Gmail and with any mailbox that speaks IMAP, such as iCloud or Fastmail.

On the Integrations page, open the Mailbox card.
In the Gmail section, connect and sign in with your Google account. June asks for two permissions: read mail, and compose (drafts and sending).
Ask June about your mail.

Google ends a Gmail connection after 7 days for now. To renew it, connect again under the same connection name; the mailbox page lists the names you used.

Create an app password with your mail provider. Use it instead of your account password.
On the Integrations page, open the Mailbox card and fill in the IMAP form: server, port, username, the app password, and the addresses you send from.
Choose Test and connect. June logs in once to check the server before it saves anything.

The server needs IMAP on port 993 (TLS) or 143 (STARTTLS), a Drafts folder and support for UIDPLUS, as Gmail, iCloud and Fastmail have with an app password. Submit the form again to add another mailbox.

Did the accountant answer my question about the VAT return?
Draft a polite reminder to everyone who has not replied to the offsite invite.

What June can do

  • Search your mail and read a message or a whole thread.
  • In Gmail, search the way you do in Gmail's own search box: has:attachment, filename:pdf, label:receipts, newer_than:7d, larger:5M, in:anywhere, exact phrases in quotes, OR and - to leave something out, on top of the usual sender, subject and date filters.
  • In Gmail, read a text attachment (CSV, JSON, Markdown, HTML, code) of up to 2 MB. PDFs and Office files are not readable yet: June tells you the file's name, type and size instead.
  • Save a plain-text draft in your mailbox's Drafts folder. You open it in your mail app, change what you like, and send it yourself.
  • Read your Gmail labels, filters, drafts, settings and what changed in the mailbox lately straight from Google, read-only.
  • In Gmail, send a message or a reply, or send a draft, after you approve it. In a chat on the web, June shows you a card with the account, the address it sends from, every recipient, the subject and the whole text before anything goes out; a reply sits in the same Gmail thread. For a draft, the card shows the draft as it stands in Gmail, with the changes you made in your mail app, its attachments and, when it says more than the text, its HTML version. If you change the draft after the card appears, June sends nothing and asks again; a draft the card can't show in full is not sent. Approve sends it once; Deny stops it. In Slack June sends nothing and says to approve it in June on the web or in the app (a step that needs your confirmation).
Find the invoices with a PDF attached from the last 30 days and list the senders
Open the CSV Anna sent this morning and total the amount column
Reply to Tom's last mail and say Thursday works

Mailboxes and organizations

A mailbox starts as personal only, so June uses it only in your own chats. To use it in every organization you're in as well (personal or organization), turn off Personal only: for Gmail in the connection's menu on the Integrations page, for IMAP on the Mailbox page.

Inside an organization you connect a mailbox over IMAP; its admins can set the mail server once, so you enter only your username, app password and addresses. Gmail sign-in is personal only for now.

What June does not do

  • It never sends without your approval, and it never sends from an IMAP or Outlook mailbox: there every reply stays a draft until you send it. A schedule cannot send either, because nobody is there to approve.
  • It never moves, labels, archives, marks or deletes your mail. A draft it sends leaves Drafts for Sent, as when you send it yourself.
  • It never adds a recipient you did not name, and it never sends because a mail asked it to.
  • It does not read PDF, Office or image attachments yet, and does not attach files to the messages it writes.
  • In an IMAP or Outlook mailbox it does not read attachments or take Gmail search operators.
  • It does not watch your inbox on its own. It reads mail when you ask, or when a schedule you set up runs with its integrations toolset on.