Skip to content

Ms365 doctor

ms365 doctor

Diagnose configuration, keyring, and Graph connectivity

Synopsis

Run local and remote health checks for the active account: config file, token cache backend, cached session, and a live GET /me. Exits non-zero when any check fails, so it is scriptable.

ms365 doctor [flags]

Examples

  ms365 doctor
  ms365 doctor -a work --json

Options

  -h, --help   help for doctor
      --json   output as JSON

Options inherited from parent commands

  -a, --account string     named account (profile) to use
      --all                follow @odata.nextLink until exhausted (list commands)
      --base-url string    Microsoft Graph base URL override (sovereign clouds)
      --client-id string   Entra app (client) ID override — defaults to the embedded Microsoft Graph Command Line Tools app
      --columns strings    comma-separated columns to show
      --dry-run            print the equivalent curl and make no request
      --jq string          gojq expression applied to the response before rendering
      --limit int          max items to return across pages (list commands)
      --no-color           disable colored output
  -o, --output string      output format: table|json|yaml|csv|id
      --quiet              suppress non-essential chatter
      --show-token         reveal the bearer token in dry-run output
      --timezone string    return mail/calendar datetimes in this timezone (Prefer: outlook.timezone, e.g. "America/Caracas")
  -v, --verbose            verbose request logging (stderr)

SEE ALSO

  • ms365 - A fast, scriptable CLI for Microsoft 365 (Microsoft Graph)