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
This command opens the connection.
This command requests for listing the capabilities that the server supports.
This command is used as a periodic poll for new messages or message status updates during a period of inactivity.
This command helps to select a mailbox to access the messages.
It is same as SELECT command except no change to the mailbox is permitted.
It is used to create mailbox with a specified name.
It is used to permanently delete a mailbox with a given name.
It is used to change the name of a mailbox.
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.


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_user = ''
imap_pass = 'password'

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

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

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

Depending on the mail box configuration, mail is displayed.