How to Download Gmail Chat Logs via IMAP

Google stores transcripts of your Hangouts chat sessions within Gmail, accessible using the Chats label. These chats aren't locked in a proprietary chat format, however. Google stores them in Gmail as any other message. And because chat transcripts look like emails, you can export them as messages if you've configured Gmail to allow IMAP connections.

Download Gmail Chat Logs via IMAP

Before following these steps, make sure IMAP access is enabled for your Gmail account.

To access and export Google chat logs using an email program:

  1. Click the gear in Gmail's top right corner.

    A screenshot of a Gmail inbox with the Settings gear highlighted
  2. Select Settings.

    A screenshot of Gmail with the Settings menu item highlighted
  3. Click the Labels tab.

    A screenshot of Gmail settings with the Labels heading highlighted
  4. Ensure that Show in IMAP is checked for Chats under System Labels.

    A screenshot of Gmail Labels settings with the Chats options highlighted
  5. Set up Gmail via IMAP in your email program.

  6. Look for chat logs in the [Gmail]/Chats folder.

    A screenshot of the Gmail folder in Outlook with the Chats option highlighted

Downloading Your Chats

Use your email program's export tools to download a local copy of the Chats folder. For example, in Outlook 2016, print all the chats to PDF or visit File > Open & Export > Import/Export | Export to a File to export the Chats folder to an Outlook personal archive folder or a comma-separated value (CSV) data file.

Although you can copy the chat transcripts from the [Gmail]/Chats folder, you cannot import them to a different Gmail account by copying to that account's [Gmail]/Chats folder.

What Chats?

Google frequently changes the names and product offerings of its instant-communication tools. As of 2019, the chats interwoven into Gmail come from Google Hangouts. Chats from many years prior may have come from GChat, Google Talk, or other Google-sponsored chat tools.