IMAP

imap.list_folders

List the mailbox's folders, e.g. INBOX, Sent, Archive, with the role the server gives each such as sent, trash or junk.

imap.search_messages

Search a folder. Every filter given must match, and from, to and cc match any of several values separated by commas. Returns each match's UID, sender, recipients, subject, date, read and flagged state and number of attachments, newest first, and a cursor. For a scheduled search, remember the cursor and pass it back next time: the search then returns only messages that arrived since, oldest first, and when more matched than limit, the next search carries on where this one stopped.

imap.get_message

Read one message by UID: its headers, its body as plain text (taken from the HTML when there is no text part) and the name, type and size of each attachment. Reading it does not mark it read.