(Chilkat2-Python) Determine the Number of Unseen Email Messages

Demonstrates how to determine how many unseen messages exist in an email account on an IMAP server.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat2 Python Downloads install with pip pip3 install chilkat2 or download... Python Module for Windows, Linux, Alpine Linux, MacOS

import sys
import chilkat2

success = False

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

imap = chilkat2.Imap()

# Connect to an IMAP server.
# Use TLS
imap.Ssl = True
imap.Port = 993
success = imap.Connect("imap.example.com")
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

# Login
success = imap.Login("***","***")
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

# Select an IMAP mailbox
success = imap.SelectMailbox("Inbox")
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

# After selecting the mailbox. the total number of emails
# is immediately available:
totalNum = imap.NumMessages
print("Num messages = " + str(totalNum))

# To determine the number of unseen messages, a call
# to Search is required, which returns the set of UIDs
# of all unseen messages.

# We can choose to fetch UIDs or sequence numbers.
fetchUids = True
messageSet = chilkat2.MessageSet()
success = imap.QueryMbx("UNSEEN",fetchUids,messageSet)
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

numUnseen = messageSet.Count
print(str(numUnseen))

print("UIDs ----")

# Display the UIDs
i = 0
while i < messageSet.Count :
    print(str(messageSet.GetId(i)))
    i = i + 1

# Disconnect from the IMAP server.
success = imap.Disconnect()