Python – IMAP

IMAP is an email retrieval protocol which does not download the emails. It just reads them and displays them. This is very useful in low bandwidth condition. Python’s client side library called imaplib is used for accessing emails over imap protocol.

IMAP stands for Internet Mail Access Protocol. It was first proposed in 1986.

Key Points:

  • IMAP allows the client program to manipulate the e-mail message on the server without downloading them on the local computer.

  • The e-mail is hold and maintained by the remote server.

  • It enables us to take any action such as downloading, delete the mail without reading the mail.It enables us to create, manipulate and delete remote message folders called mail boxes.

  • IMAP enables the users to search the e-mails.

  • It allows concurrent access to multiple mailboxes on multiple mail servers.

IMAP Commands

The following table describes some of the IMAP commands:

S.N. Command Description
1 IMAP_LOGIN
This command opens the connection.
2 CAPABILITY
This command requests for listing the capabilities that the server supports.
3 NOOP
This command is used as a periodic poll for new messages or message status updates during a period of inactivity.
4 SELECT
This command helps to select a mailbox to access the messages.
5 EXAMINE
It is same as SELECT command except no change to the mailbox is permitted.
6 CREATE
It is used to create mailbox with a specified name.
7 DELETE
It is used to permanently delete a mailbox with a given name.
8 RENAME
It is used to change the name of a mailbox.
9 LOGOUT
This command informs the server that client is done with the session. The server must send BYE untagged response before the OK response and then close the network connection.

Example

In the below example we login to a gmail server with user credentials. Then we choose to display the messages in the inbox. A for loop is used to display the fetched messages one by one and finally the connection is closed.

import imaplib
import pprint

imap_host = 'imap.gmail.com'
imap_user = '[email protected]'
imap_pass = 'password'

# connect to host using SSL
imap = imaplib.IMAP4_SSL(imap_host)

## login to server
imap.login(imap_user, imap_pass)

imap.select('Inbox')

tmp, data = imap.search(None, 'ALL')
for num in data[0].split():
	tmp, data = imap.fetch(num, '(RFC822)')
	print('Message: {0}\n'.format(num))
	pprint.pprint(data[0][1])
	break
imap.close()

Depending on the mail box configuration, mail is displayed.