Sample code for 30+ languages & platforms
Swift Requires Chilkat v11.0.0+

Gmail IMAP: Connect with an App Password

Authenticate to Gmail over implicit TLS on port 993, then open INBOX read-only and report its message count. No message is downloaded or changed. This replaces ordinary-password login and removes authentication-session logging.

Personal Gmail IMAP is always enabled. Workspace administrators can restrict IMAP access. For OAuth2, use Gmail IMAP token authentication.

Use an account-specific app password generated after enabling 2-Step Verification, loaded from protected configuration. A normal Google password will not work. App passwords may be unavailable under account or Workspace policy; OAuth2 is preferred. Changing the Google account password revokes app passwords. The obsolete less-secure-apps switch is not a setup option. Google app-password requirements.

See the Gmail SMTP, IMAP, and POP3 guide for current authentication choices and Gmail-specific examples.

Reference documentation

Chilkat Swift Downloads

Swift

func chilkatTest() {
    var success: Bool = false

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.

    var mailbox: String? = "user@example.com"
    let imap = CkoImap()!
    imap.ssl = true
    imap.port = 993
    imap.requireSslCertVerify = true
    success = imap.connect(hostname: "imap.gmail.com")
    if success != true {
        print("Could not establish the Gmail IMAP TLS connection.")
        return
    }

    success = imap.login(login: mailbox, password: "YOUR_16_CHARACTER_APP_PASSWORD")
    if success != true {
        imap.disconnect()
        print("IMAP authentication failed. Check the app password, mailbox, and account policy.")
        return
    }

    //  EXAMINE is read-only; no message is downloaded, marked read, moved, or deleted.
    success = imap.examineMailbox(mailbox: "INBOX")
    if success != true {
        imap.logout()
        imap.disconnect()
        print("Could not examine INBOX.")
        return
    }

    print("Messages in INBOX: \(imap.numMessages.intValue)")
    success = imap.logout()
    imap.disconnect()
    if success != true {
        print("The read-only operation completed, but IMAP logout failed.")
    }


}