Gmail POP3: Recent Mode with Persistent UIDL Tracking
See more GMail SMTP/IMAP/POP Examples
Use recent:user@example.com to access Gmail's recent POP delivery window, then download each UIDL only once. This example uses an app password, requiring 2-Step Verification and an account policy that allows app passwords. Enable POP and select Keep Gmail's copy in the Inbox. An ordinary account password will not work. If app passwords are unavailable, use the OAuth IMAP examples.
Recent mode exposes approximately the last 30 days of mail and is useful when multiple POP clients need the same messages. Keep the recent prefix out of SMTP settings. This is a rolling window, not a complete-mailbox backup; polling after a long gap can miss older mail.
UIDLs stay as opaque strings. A SHA-256 filename derived from mailbox plus UIDL identifies each saved MIME file. The final file doubles as the persistent completion receipt: a second run skips it. A partial download or failed write is never marked complete, and a leftover .part file is retried. The code sends no DELE commands.
Keep this private directory dedicated to the downloader, use a stable mailbox spelling, and run only one writer at a time. Moving or deleting final files discards the tracking information and permits a new download while the message is still available. For business processing beyond saving MIME, use an application transaction and idempotent handling.
Chilkat C# Downloads
bool success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
// Use a private directory dedicated to this application's downloaded mail.
string mailbox = "user@example.com";
string appPassword = "YOUR_16_CHARACTER_APP_PASSWORD";
Chilkat.FileAccess files = new Chilkat.FileAccess();
success = files.DirEnsureExists("gmail-pop-mail");
if (success != true) {
Debug.WriteLine("Could not create the private download directory.");
return;
}
Chilkat.MailMan mailman = new Chilkat.MailMan();
mailman.MailHost = "pop.gmail.com";
mailman.MailPort = 995;
mailman.PopSsl = true;
mailman.RequireSslCertVerify = true;
Chilkat.StringBuilder joined1 = new Chilkat.StringBuilder();
joined1.Append("recent:");
joined1.Append(mailbox);
mailman.PopUsername = joined1.GetAsString();
mailman.PopPassword = appPassword;
// Use an eligible account's app password loaded from protected configuration.
// The recent: prefix is only for POP; never add it to an SMTP username.
success = mailman.Pop3BeginSession();
if (success != true) {
mailman.Pop3EndSessionNoQuit();
Debug.WriteLine("POP login failed. Check the app password, POP setting, and account policy.");
return;
}
Chilkat.StringTable uidls = new Chilkat.StringTable();
success = mailman.FetchUidls(uidls);
if (success != true) {
mailman.Pop3EndSessionNoQuit();
Debug.WriteLine("Could not list POP UIDLs.");
return;
}
Chilkat.Crypt2 hash = new Chilkat.Crypt2();
hash.HashAlgorithm = "sha256";
hash.EncodingMode = "hex";
hash.Charset = "utf-8";
Chilkat.BinData mime = new Chilkat.BinData();
int saved = 0;
int skipped = 0;
int i = 0;
while ((i < uidls.Count)) {
string uidl = uidls.StringAt(i);
// Never use the opaque server UIDL as a filesystem path.
Chilkat.StringBuilder joined2 = new Chilkat.StringBuilder();
joined2.Append(mailbox);
joined2.Append("\n");
joined2.Append(uidl);
string fileKey = hash.HashStringENC(joined2.GetAsString());
if (hash.LastMethodSuccess != true) {
mailman.Pop3EndSessionNoQuit();
Debug.WriteLine("Could not construct the local UIDL key.");
return;
}
Chilkat.StringBuilder joined3 = new Chilkat.StringBuilder();
joined3.Append("gmail-pop-mail/");
joined3.Append(fileKey);
joined3.Append(".eml");
string path = joined3.GetAsString();
int exists = files.FileExists3(path);
if (exists < 0) {
mailman.Pop3EndSessionNoQuit();
Debug.WriteLine("Could not check the local download receipt.");
return;
}
if (exists == 1) {
skipped = skipped + 1;
}
else {
success = mailman.FetchMimeBd(uidl,mime);
if (success != true) {
mailman.Pop3EndSessionNoQuit();
Debug.WriteLine("Download failed; the UIDL was not marked complete.");
return;
}
// A final .eml file is the persistent completion receipt for this UIDL.
// Save to a sibling temporary file first. A leftover .part file is not a receipt.
Chilkat.StringBuilder joined4 = new Chilkat.StringBuilder();
joined4.Append(path);
joined4.Append(".part");
success = mime.WriteFile(joined4.GetAsString());
if (success != true) {
mailman.Pop3EndSessionNoQuit();
Debug.WriteLine("Could not save the complete MIME file.");
return;
}
Chilkat.StringBuilder joined5 = new Chilkat.StringBuilder();
joined5.Append(path);
joined5.Append(".part");
success = files.FileRename(joined5.GetAsString(),path);
if (success != true) {
mailman.Pop3EndSessionNoQuit();
Debug.WriteLine("Could not commit the downloaded message. Keep the temporary file for diagnosis.");
return;
}
saved = saved + 1;
}
i = i + 1;
}
// No DELE commands: leave the messages on Gmail for other clients/recent-mode polls.
success = mailman.Pop3EndSession();
Debug.WriteLine("Saved: " + Convert.ToString(saved) + " Already saved: " + Convert.ToString(skipped));
if (success != true) {
Debug.WriteLine("The local files are committed, but closing the POP session failed.");
}