How to Import MBOX to G Suite (Google Workspace) - Complete Guide

This guide provides a detailed walkthrough on importing MBOX files into Google Workspace (formerly G Suite) using the SysTools Import Tool.

Pre-Requisites

  • Microsoft .NET Framework 4.8.0 or above.
  • Create a Google Console Project, Enable APIs (Gmail API, Google Calendar API, Contacts API, Google Drive API as per workload), and Add Scopes. Read more...
  • Microsoft Visual C++ Redistributable Latest (Visual Studio 2015, 2017, 2019, and 2022) should be installed. Download
  • Ensure your MBOX files are accessible and not corrupted.

Step-by-Step Guide to Import MBOX to Google Workspace

STEP 1

Download, install, and launch the SysTools Import Tool. If the tool is not activated, refer to the activation guide: Activation Steps.

The tool includes a Help section detailing each import mode. Click the "Help" button on the top right to access this information.

SysTools Import Tool - Help Screen

STEP 2

On the Setup tab, select the source and destination platforms:

  • Source: Choose MBOX.
  • Destination: Choose G Suite.

Select MBOX as Source and G Suite as Destination

STEP 3

Under Workload selection, check the Email checkbox to allow email import.

Select Email for Workload Selection

STEP 4

(Optional) Apply Date Filter: If you need to import emails from a specific date range, check the Date Filter box. Select the From Date and To Date using the calendar icons.

Apply Date Filter

Once the setup is complete, click the Next button.

Setup Complete - Click Next

STEP 5

On the Source: MBOX screen, you need to specify the path to your MBOX files.

You will need to put MBOX files in the folders(created with the name of target O365 email IDs) as described below:

MBOX Structure level 1

Create a folder in root drive, like:

MBOX Structure level 2

etc...

Click the folder icon next to Import folder path. Ensure the folder name length is less than 60 characters, sufficient disk space is available, and correct file system permissions are set.

MBOX Source Screen - Import Folder Path

And then select the folder " C:/MBOX/" into our tool to migrate MBOX files.

STEP 6

In the "Select Folder" dialog, navigate to the folder containing your MBOX files (e.g., C:\MBOX) and click Select Folder.

Browse and Select MBOX Folder

After selecting the folder, click Validate to check permissions (Read file system, Read Email).

Once validation is successful (indicated by green checkmarks), click Next.

Source Validated - Click Next

STEP 7

On the Destination: G Suite screen, provide the necessary credentials:

  • Admin Email: Enter your G Suite administrator email address.
  • Service Account: Enter the Service Account ID generated from Google Cloud Platform.
  • Certificate File: Click the upload icon to select the .p12 certificate file for your service account.

For help with Google Cloud Platform project creation, refer to: Google Project Creation Steps.

G Suite Destination Screen - Credentials

STEP 8

After entering the G Suite credentials, click Validate to ensure the account has the required permissions (Read User, Write Email).

G Suite Credentials Filled - Click Validate

Once validation is successful (indicated by green checkmarks), click Next.

G Suite Destination Validated - Click Next

STEP 9

On the Users screen, you can add source users for processing. You have three options:

  • Fetch Users: Automatically fetches users from the configured source (may attempt to identify MBOX files as users).
  • Import Users: Allows you to import users using a CSV file (recommended for MBOX).
  • Download Template: Downloads a sample CSV template for mapping source MBOX files to destination G Suite users.

User Mapping Options

STEP 10

Option A: Import Users via CSV (Recommended for MBOX)

1. Click Download Template to get a sample CSV file.

Download User Mapping Template

2. Open the downloaded UserMappingSample.csv file and edit it. Fill in the Source User (MBOX file name, often without extension, or full path if needed), Destination User (G Suite email), and set MarkForExecution to TRUE for users to be imported.

Edit User Mapping CSV Template

3. Save the CSV. Back in the tool, click Import Users.

Click Import Users

4. Click the browse icon, select your edited CSV file, and click Open.

Browse and Open CSV File

5. Click Upload.

Upload CSV File

6. A confirmation message will appear ("X Users imported. Processing Completed"). Click OK.

User Import from CSV Complete

STEP 11

Option B: Fetch Users

1. Click Fetch Users. This will attempt to fetch users from the configured source account (for MBOX, it might identify based on file names).

2. A confirmation dialog will appear. Click Continue.

Fetch Users Confirmation

3. A success message ("X user(s) fetched. Processing Completed") will appear. Click OK.

User Fetching Complete

STEP 12

The user list will be populated. Review the list:

  • Select users for import by checking the checkboxes next to their names.
  • (Optional) Set import priority using the star icon.
  • Ensure the Destination Email is correctly mapped. You can edit this field if necessary.
  • (Optional) Use the Show selected toggle to filter the list.

User List Populated

After selecting and mapping users, click Validate.

Select and Validate Users

A confirmation message ("X User(s) validated. Processing Completed") will appear. Click OK.

User Validation Complete

STEP 13

Once users are validated, click the Start Import button.

Click Start Import Button

A dialog will show your license information (Purchased, Consumed, Available). Click Start to begin the import.

Confirm License and Start Import

A confirmation message ("Import started successfully.") will appear. Click OK.

Import Started Successfully

STEP 14

The import process will begin. You can monitor its progress on the Import tab, under the Pending and In Progress sub-tabs.

Import Pending Tab

The In Progress tab shows active imports. A banner may indicate that some features are unavailable during execution.

Import In Progress Tab

(Optional) Stop Import: If needed, click Stop Import.

Stop Import Button

Confirm by clicking Yes in the dialog.

Confirm Stop Import

A success message ("The process has been stopped successfully.") will appear. Click OK. Stopped imports will show their partial status.

Import Stopped Successfully

Status of a stopped item.

Status of stopped email import

STEP 15

Once the import finishes, successfully imported items will appear under the Completed tab.

Import Completed Tab

(Optional) Re-Run Import: Click the Re-Run Import dropdown for more options:

  • Retry Failed Items: Re-attempts import for items that previously failed. Select users and click Start.
  • Re-Run Full Import: Re-imports all data for selected users. Select users and click Start.
  • Delta Import: Imports only new data that has arrived since the last import. Select users and click Start.

Re-Run Import Options

Example: Retry Failed Items dialog.

Retry Failed Items Dialog

Example: Re-Run Full Import dialog.

Re-Run Full Import Dialog

Example: Delta Import dialog.

Delta Import Dialog

STEP 16

After the import, you can download reports. Click the Download Report dropdown:

Download Report Options

1. Import Summary Report:

  • Select this option and save the Import-Summary-Report-[date-time].csv file.

Save Import Summary Report

The summary report provides a high-level overview of the import.

View Import Summary Report

2. Detailed Report:

  • Select this option. In the "Download Reports" dialog, select users and click Download.

Download Detailed Report - Select Users

  • In the "Generate Report" dialog, click Download again.

Generate Detailed Report - Click Download

  • Save the Import-Detailed-Report-[date-time].zip file.

Save Detailed Report ZIP File

  • Extract the ZIP file to view individual detailed CSV reports for each user.

Extract Detailed Report ZIP File

The detailed report lists individual items and their status.

View Detailed Import Report

STEP 17

(Optional) Adjust Settings:

Navigate to the Settings tab.

Under General, you can adjust the Concurrent user slider to set the number of users processed simultaneously per account (e.g., to 10). Click Save.

Adjust Concurrent User Settings

Free Download SysTools Import Tool Download Now