Sample code for 30+ languages & platforms
Objective-C 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 Objective-C Downloads

Objective-C
#import <NSString.h>
#import <CkoImap.h>

BOOL success = NO;

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

NSString *mailbox = @"user@example.com";
CkoImap *imap = [[CkoImap alloc] init];
imap.Ssl = YES;
imap.Port = [NSNumber numberWithInt:993];
imap.RequireSslCertVerify = YES;
success = [imap Connect: @"imap.gmail.com"];
if (success != YES) {
    NSLog(@"%@",@"Could not establish the Gmail IMAP TLS connection.");
    return;
}

success = [imap Login: mailbox password: @"YOUR_16_CHARACTER_APP_PASSWORD"];
if (success != YES) {
    [imap Disconnect];
    NSLog(@"%@",@"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: @"INBOX"];
if (success != YES) {
    [imap Logout];
    [imap Disconnect];
    NSLog(@"%@",@"Could not examine INBOX.");
    return;
}

NSLog(@"%@%d",@"Messages in INBOX: ",[imap.NumMessages intValue]);
success = [imap Logout];
[imap Disconnect];
if (success != YES) {
    NSLog(@"%@",@"The read-only operation completed, but IMAP logout failed.");
}