Import MSG to G Suite - Mac Software Guide

A Detailed Guide to Executing the Import Process on macOS


        Pre-Requisites

  • macOS 10.8 or later.
  • A Google Console Project must be created with the required APIs enabled and Scopes added. Read more...


Following are the Steps to Import MSG to G Suite on Mac

STEP 1

Download, install, and launch the SysTools Import Tool for Mac. This is the main "Setup" screen where you begin the configuration. You can also access the "Help" section from the bottom-left corner for more information.

Initial setup screen of the import tool


The built-in Help section provides detailed explanations for each feature.

Help section providing setup details

STEP 2

First, define the import sources. For the source, select MSG. For the destination, select G Suite.

Select MSG as source and G Suite as destination

STEP 3

In the "Workload Selection" area, choose the categories of data you wish to import. For MSG files, check the Email option.

Email workload selected for import

STEP 4

After configuring the workload, click Next. On the "Source" screen, you must specify the folder path containing your MSG files. Click the folder icon to browse.

Source selection screen with empty import folder path


Crucially, your MSG files must be arranged in a specific folder structure. Create a parent folder, and inside it, create subfolders named with the exact target G Suite email address. Place each user's MSG files inside their respective folder, as shown below.

Correct folder structure for source MSG files


In the file dialog, navigate to and select the parent folder (e.g., "MSG") and click "Open".

macOS file dialog to select the MSG folder

STEP 5

Once the folder path is populated, click the Validate button to ensure the application has the necessary read permissions.

Import folder path populated, highlighting validate button


Upon successful validation, the tool will display the confirmed permissions. Click Next.

Source permissions validated and displayed

STEP 6

On the "Destination" screen, you need to provide your G Suite project credentials. Fill in the Admin Email, Service Account, and upload the Certificate File (.p12).

Destination configuration screen for G Suite


With the credentials entered, click Validate to authenticate with Google Workspace.

G Suite credentials filled in, highlighting validate button

STEP 7

After successful validation, the required destination permissions are shown. Click Next to proceed to user mapping.

Destination permissions validated, highlighting next button

STEP 8

On the "Users" screen, you can add accounts for import. You have three options:

  • Import Users: Allows you to upload a CSV file with user mappings.
  • Fetch Users: Automatically detects users from the source folder structure.
  • Download Template: Provides a sample CSV file to ensure correct formatting.

User import options: Fetch, Import, and Download Template


Option 1: Import Users (CSV Method)

First, click Download Template to save a sample CSV file. You must populate this file with your source and destination user email addresses.

Save dialog for downloading the user mapping CSV template

Once your CSV is ready, click Import Users, select your file, and click "Open".

Import Users pop-up to upload a CSV file

File explorer showing the CSV file selected for upload

Click Upload to import the user list from the file.

User about to upload the selected CSV file

A success message will confirm the number of users imported from the CSV.

Success message confirming three users have been imported


Option 2: Fetch Users (Alternative Method)

Alternatively, click Fetch Users to automatically detect users from the source folder structure you defined in Step 4. Click "Continue" on the confirmation pop-up.

Confirmation pop-up for Fetch Users operation

A success message will confirm how many users were found.

Success message confirming two users have been fetched

STEP 9

After fetching or importing, the users will be listed. Ensure each Source Email is correctly mapped to a Destination Email.

User list populated on the screen


Select the users you wish to process and click Validate.

User list with mappings, highlighting validate button


A confirmation message will appear after the users are successfully validated. Click "OK".

User validation success message

STEP 10

Before starting the import, you can navigate to the Settings tab to adjust performance options, such as the number of Concurrent users to process simultaneously.

Settings tab showing concurrent users slider

STEP 11

With the users validated, the Start Import button becomes active. Click it to begin.

Start Import button highlighted


A final confirmation dialog will show your available license count. Click "Start" to commence the import process.

License check dialog before starting import


You will receive a notification that the import has started successfully. Click "OK".

Import started successfully message

STEP 12

Navigate to the "Import" tab to monitor the live progress. If you need to interrupt the process, you can click the Stop Import button.

Import in progress screen


A dialog will ask for confirmation. Click "Yes" to stop the import.

Confirmation dialog to stop the import


A message confirms that the process has been stopped. Click "OK".

Success message confirming import was stopped


The UI will then show the import status as "Stopped" with a red icon.

Import status showing as stopped

STEP 13

Once the import finishes, the user will be moved to the "Completed" tab. A green checkmark signifies a successful operation, while a red icon indicates a stopped one.

Completed tab showing successful and stopped imports

STEP 14

After completion, you can use the Download Report feature to save logs.

Download Report dropdown menu


The Import Summary Report provides a single CSV with high-level statistics for all users.

Summary report open in a spreadsheet application


For more detail, select the Detailed Report option.

Selecting detailed report option

This report downloads a ZIP file containing individual CSVs for each data type with item-level status.

Extracting the detailed report ZIP file

You can view the detailed status for each item in a spreadsheet.

Extracted folder containing detailed CSV reports

STEP 15

The tool also provides a Re-Run Import feature for various scenarios.

Re-Run Import dropdown menu

Retry Failed Items: Re-processes only the items that failed or were stopped.

Retry Failed Items dialog

Re-Run Full Import: Performs the entire import again for the selected users.

Re-Run Full Import dialog

Delta Import: Imports only new data that has arrived since the last import, preventing duplicates.

Delta Import dialog

STEP 16

Finally, log in to the destination Google Workspace account to verify that your data has been imported successfully.

Emails:

Before:

Empty Gmail inbox before import

After:

Gmail inbox populated with imported emails

Free Download SysTools Import Tool for Mac Download Now