(Chilkat2-Python) Mark IMAP Email as Read/Unread (Seen/Unseen)

Demonstrates how to mark emails as read or unread.

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 assumes 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("myLogin","myPassword")
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

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

# Set PeekMode so that downloaded messages are not
# automatically marked as seen.
imap.PeekMode = True

# The NumMessages property contains the number of messages 
# in the currently selected mailbox.
numMsgs = imap.NumMessages
if (numMsgs == 0):
    sys.exit()

email = chilkat2.Email()

for i in range(1,(numMsgs)-1):
    # Download each email by sequence number (not UID)
    success = imap.FetchEmail(False,i,False,email)
    if (success == False):
        print(imap.LastErrorText)
        sys.exit()

    # If desired, mark the email as SEEN.  There are two
    # ways to do it:

    # 1) Set the flag directly by using the sequence number
    # Indicate that we are passing a sequence number and
    # not a UID:
    bIsUid = False
    # Set the SEEN flag = 1 to mark the email as SEEN,
    # or set it to 0 to mark it as not-seen.
    success = imap.SetFlag(i,bIsUid,"SEEN",1)
    if (success == False):
        print(imap.LastErrorText)
        sys.exit()

    # 2) Alternatively, we can use the email object.
    # When an email is downloaded from the IMAP server
    # Chilkat will add a "ckx-imap-uid" header to the email.
    # This makes it possible to know the UID associated with
    # the email.  (This is not the sequence number, which may change
    # from session to session, but the UID which does not change.
    # The SetMailFlag method is identical to SetFlag, except
    # it gets the UID from the ckx-imap-uid header.
    # For example:
    success = imap.SetMailFlag(email,"SEEN",1)
    if (success == False):
        print(imap.LastErrorText)
        sys.exit()

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