Install the Microsoft Graph command-line interface (CLI)

1. Download the .zip file beginning with msgraph-cli-win-x64 from the Assets section of the GitHub Releases page.
2. Extract the contents of the file into a directory.

Windows environment setup (Optional)

1. Open Settings.

2. Select About, then Advanced system settings.

3. Select Environment Variables....

4. Locate and select Path, then select Edit.

   Note

   The Path variable is present in User variables as well as System variables. Updating the variable in User variables will only update the current user's path. Updating the variable in System variables will update the path for all users on the computer.

5. Add the full path to the directory containing mgc.exe.

1. Download the .tar.gz file beginning with msgraph-cli-linux-x64 from the Assets section of the GitHub Releases page.
2. Extract the contents of the file into a directory.

Linux environment setup

To update PATH for your current session, run the following command while in the directory containing mgc.

export PATH=$PATH:$(PWD)

Alternatively, you can update PATH permanently by editing your shell profile (~/.bash-profile or ~/.zsh-profile). Add the following line to your profile.

export PATH=$PATH:[path-to-the-cli-folder]

Configure gnome-keyring

The following steps are required on Linux distributions that do not have a desktop environment.

1. Install gnome-keyring and libsecret with the following command.

   sudo apt-get install --assume-yes gnome-keyring libsecret-1-0
   

2. Run a gnome-keyring daemon process with the following commands. Replace secure-password with a secure password of your choosing.

   sudo setcap cap_ipc_lock=+ep $(which gnome-keyring-daemon)
   
   export DBUS_SESSION_BUS_ADDRESS=$(dbus-daemon --session --fork --print-address)
   
   export KEYRING_PASSWORD=secure-password
   
   dbus-run-session -- echo "$KEYRING_PASSWORD" | gnome-keyring-daemon --daemonize --components=secrets --unlock
   

   Note

   The previous commands must be run every time the system restarts.

1. Download the .tar.gz file beginning with msgraph-cli-osx-x64 (for Intel-based Mac) or msgraph-cli-osx-arm (for M1 or M2-based Mac) from the Assets section of the GitHub Releases page.
2. Extract the contents of the file into a directory.

macOS environment setup

To update PATH for your current session, run the following command while in the directory containing mgc.

export PATH=$PATH:$(PWD)

Alternatively, you can update PATH permanently by editing your shell profile (~/.bash-profile or ~/.zsh-profile). Add the following line to your profile.

export PATH=$PATH:[path-to-the-cli-folder]