Email

Email

Connect a mailbox over IMAP and SMTP with an app password.

Personal Agent Proxy connects a mailbox with an app password: a password your mail provider makes for one app, apart from the one you sign in with. Revoking it in your mail account disconnects Personal Agent Proxy and nothing else. Emails stay with the provider; nothing is copied.

What agents can do

Agents see the inbox, drafts and sent mail as one list. You can allow each action separately:

  • Read lists, opens and searches email. A mailbox over IMAP has no web address for an email, so an agent points you to one by its subject, sender and date rather than a link. An email opens with its attachments listed, and an attachment is read as text: a spreadsheet's tabs as CSV, a PDF's or a Word document's text, a forwarded email, or a text file as it is, the first 100,000 characters of it. Images and other files can't be read, but any attachment can be made a blob, to put in a drive or attach to another email.
  • Mark read or unread, Flag, Archive and Move to Trash act on messages in the inbox, and require Read. Trash can still be restored at the provider.
  • Write drafts creates, edits and deletes drafts, and requires Read. A draft takes a Cc and a Bcc beside its To. Received messages are never edited or deleted for good. A reply to an email in the inbox or sent mail is saved as a draft in its thread.
  • Send sends a new email or a saved draft. It does not require Read, so an agent can send without seeing the mailbox. Sending a reply needs Read too, since it reads the email it answers.

An agent attaches files to a draft, a reply or an email it sends by naming blobs it made: another email's attachment, to forward it, a file from a drive, or a file from its own shell. They go out under their own names, 25 MB together at most, or less where the mail server takes less. A draft keeps the attachments it has when it is edited, with any named then added, and when it is sent.

A reply goes to whoever the email asks replies to go to, else its sender, or, for an email you sent, to whom it went, under the email's subject with "Re:", and joins its thread. A reply to all also goes to everyone else the email went to and copies whom it copied, never the mailbox itself. An email opens with its Message-ID, which a reply names as the email it answers.

Connect a mailbox

Make an app password

Follow the steps for your provider: Gmail, iCloud, Fastmail, Yahoo or any other.

Connect the mailbox

Open Connections and permissions, then Add connection, and Connect on Email. Pick the provider, then enter the mailbox's address and the app password.

Give agents access

A new mailbox gives agents no access. On the connection's page, turn on the actions every agent gets by default, or set them for one agent on the agent's page.

When it does not connect

"The mailbox turned the password down." Check that the address is the mailbox the password was made for, or make a new app password.

"The mail server could not be reached." With Other, check the servers and the SMTP port. On your own server, see Troubleshooting.