Skip to main content

Import MSG to Office 365 - Mac Software Guide

A Detailed Guide to Executing the MSG File Data Import Process on macOS


        Pre-Requisites

  • Create Console Project in Office 365. Read more...
  • Microsoft .NET Framework 4.8.0 or above
  • Microsoft Visual C++ Redistributable Latest (Visual Studio 2015, 2017, 2019, and 2022) Should Be Installed. Download


Following are the Steps to Import MSG to Office 365 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.

Initial setup screen of the import tool


You can access the built-in "Help" section from the bottom-left corner for a detailed overview of the setup process.

Help section providing setup details

STEP 2

First, define the import platforms. For the source, select MSG. For the destination, select Office 365.

Select MSG as source and Office 365 as destination

STEP 3

In the "Workload Selection" area, check the Email option to import your MSG files.

Email workload selected for import

STEP 4

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

Correct folder structure for source MSG files


After selecting 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


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

macOS file dialog to select the source folder

Once selected, the path will appear in the "Import Folder Path" field.

Import folder path populated

STEP 5

Click the Validate button to ensure the application has the necessary read permissions. Upon success, click Next.

Source permissions validated and displayed

STEP 6

On the "Destination" screen, provide your Office 365 credentials. Fill in the Admin Email and Application ID.

Destination configuration screen for Office 365


With the credentials entered, click Validate to authenticate with Office 365.

Office 365 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, add accounts for import. You have two main methods: importing a CSV or fetching users automatically from the source folder structure.

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 folder names and destination Office 365 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 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 by controlling how many mailboxes are imported simultaneously with the Concurrent users slider.

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. You can see the ongoing process in the "In Progress" tab.

Import in progress screen


If you need to interrupt the process, you can click the Stop Import button.

Stop import button highlighted


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 in the "Completed" tab.

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. This downloads a ZIP file containing an item-level status report.

Selecting detailed report option

You can then extract the archive to view the individual reports.

Extracting the detailed report ZIP file

Each report provides an item-level status for every email.

Detailed report showing item-level status

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 Office 365 account to verify that your data has been imported successfully.

Emails:

Before:

Empty Outlook inbox before import

After:

Outlook inbox populated with imported emails

Free Download SysTools Import Tool for Mac Download Now