This repository has been archived. The Microsoft Graph CLI is now being developed here: https://github.com/microsoftgraph/msgraph-cli.

It is said that imitation is the sincerest form of flattery and if you are familiar with the Azure CLI, you can tell we are fans. The Microsoft Graph CLI leverages the same tool chain that is used to build the Azure CLI, but instead brings the entire surface area of Microsoft Graph to your command shell.

This project is still in its early phases, but we are building not only on the work of the Azure CLI team but also on the Microsoft Graph PowerShell SDK project to enable us to quickly generate a CLI for all the new capabilities of Microsoft Graph as soon as they are available.

Windows

Download directly from the releases.

$ mgc [ group ] [ command ] {parameters}

$ mgc login --scopes "user.read.all"

You can use the --query parameter and the JMESPath query syntax to customize your output.

$ mgc users user list --query "[?userType=='Member'].{name: displayName, email: mail}" --output table

You can manage extensions using the extension command. Currently, beta commands aren't shipped with the CLI and are available as extensions.

To view the list of available extensions, use the list-available sub-command

$ mgc extension list-available

To add an extension, use the add sub-command

$ mgc extension add --name extensionname

To remove an extension, use the remove sub-command

$ mgc extension remove --name extensionname

For more help on the extension capabilities, use the command

$ mgc extension --help

Name                      Email
------------------------  -------------------------------------
Conf Room Adams           Adams@M365x555627.OnMicrosoft.com
Adele Vance               AdeleV@M365x555627.OnMicrosoft.com
MOD Administrator         admin@M365x555627.OnMicrosoft.com
Alex Wilber               AlexW@M365x555627.OnMicrosoft.com

For scripting purposes, we output certain exit codes for differing scenarios.

If you encounter any bugs with the tool please file an issue in the Issues section of our GitHub repo.

If you would like to setup a development environment and contribute to the CLI, read Setting Up Your Development Environment.

This project has adopted the Microsoft Open Source Code of Conduct.

For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.