Microsoft Graph 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.

Installation

Windows

Download directly from the releases.

Usage

$ mgc [ group ] [ command ] {parameters}

Get Started

Login

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

Query

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

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

Exit codes

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

Exit Code	Scenario
0	Command ran successfully.
1	Generic error; server returned bad status code, CLI validation failed, etc.
2	Parser error; check input to command line.

Common scenarios and use Microsoft Graph CLI effectively

More samples and snippets

Reporting issues and feedback

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

Developer setup

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

Contribute code

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.