Skip to content

Configure CLI for Microsoft 365

You can configure CLI for Microsoft 365 to your personal preferences using its settings. Settings are stored on the disk in the current user's folder: C:\Users\user\.config\configstore\cli-m365-config.json on Windows and /Users/user/.config/configstore/cli-m365-config.json on macOS. The configuration file is created when you set the settings for the first time.

To reset settings to their default values, remove them from the configuration file or remove the whole configuration file.

Configuring settings

You can configure the specific setting using the cli config set command. For example, to configure CLI to automatically show help when executing a command failed, execute:

m365 cli config set --key showHelpOnFailure --value true

Available settings

Following is the list of configuration settings available in CLI for Microsoft 365.

Setting name Definition Default value
autoOpenBrowserOnLogin Automatically open the browser to the Azure AD login page after running m365 login command in device code mode. This setting will be replaced by autoOpenLinksInBrowser in the next major release. false
autoOpenLinksInBrowser Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using m365 login in device code mode. This setting will replace autoOpenBrowserOnLogin in the next major release. false
copyDeviceCodeToClipboard Automatically copy the device code to the clipboard when running m365 login command in device code mode false
csvEscape Single character used for escaping; only apply to characters matching the quote and the escape options "
csvHeader Display the column names on the first line true
csvQuote The quote characters surrounding a field. An empty quote value will preserve the original field, whether it contains quotation marks or not.
csvQuoted Quote all the non-empty fields even if not required false
csvQuotedEmpty Quote empty strings and overrides quoted_string on empty strings when defined false
errorOutput Defines if errors should be written to stdout or stderr stderr
output Defines the default output when issuing a command json
printErrorsAsPlainText When output mode is set to json, print error messages as plain-text rather than JSON true
prompt Prompts for missing values in required options false
showHelpOnFailure Automatically display help when executing a command failed true