Skip to main content
command CX Codex official · Anthropic

consent — Claude Code command: Azure approval and install

This Claude Code command guides Azure admin consent for Entra SSO and Outlook access to Microsoft Graph. A tenant admin opens the supplied URL and approves the permissions.

Apache-2.0 ★ 41,441 updated 2026-09-21

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add anthropics/financial-services
/plugin install claude-for-msft-365-install@claude-for-financial-services
Open on GitHub

What consent does

The command explains when Azure admin consent is required and provides URLs for Entra SSO and Outlook access to Microsoft Graph. Entra consent applies only when entra_sso=1; if graph_client_id points to a separately registered Entra app, consent is handled for that app. Graph consent is required when deploying the Outlook manifest, even with Entra SSO turned off.

A Global Admin signed in to the target tenant opens the URL and accepts the request. The command also gives an Azure CLI check using az ad sp show. Without Graph consent, users encounter an admin approval prompt when Outlook first tries to read mail.

What it helps with

  • grant tenant consent for Entra SSO
  • approve Graph access for an Outlook manifest
  • check whether the tenant has a service principal
  • use a separately registered Entra app for Outlook

Example prompts for the agent

  • Set up Azure admin consent for Entra SSO.
  • Explain how to approve Microsoft Graph for the Outlook manifest.
  • Show how to check tenant consent with az ad sp show.

How to install consent

1Plugin marketplace

/plugin marketplace add anthropics/financial-services
/plugin install claude-for-msft-365-install@claude-for-financial-services

2Manually: put the files in place

.claude/commands/consent.md

Call it with /consent. For all projects use ~/.claude/commands/

Questions about consent

How do I install consent in Claude Code?

Run /plugin marketplace add anthropics/financial-services, then run /plugin install claude-for-msft-365-install@claude-for-financial-services.

What does consent do?

It guides an administrator through approving Entra SSO or Microsoft Graph access for Outlook. It also provides an Azure CLI command to verify the tenant service principal.

What is required to use consent?

A Global Admin signed in to the target tenant must approve the request. Entra consent is needed when entra_sso=1; Graph consent is needed when deploying the Outlook manifest.

Source text

consent.md · Apache-2.0
---
description: Azure admin consent URLs — one-time tenant approval for Entra SSO and Outlook Graph access
---

# Azure admin consent

**Only needed when `entra_sso=1`** in the manifest. Gateway and Vertex setups
with org-wide config don't use Entra and can skip this. If you set
`graph_client_id` (your own Entra app), this page doesn't apply either — you
manage consent on your app directly.

One-time per tenant. A Global Admin opens this URL, clicks Accept, done. Until
they do, NAA sign-in inside the add-in fails for every user in the tenant.

## The URL

Same URL for every customer — `/organizations/` resolves the tenant from
whoever signs in. No substitution needed.

```
https://login.microsoftonline.com/organizations/adminconsent?client_id=c2995f31-11e7-4882-b7a7-ef9def0a0266&redirect_uri=https://pivot.claude.ai/auth/callback
```

Print it. Tell them: open in a browser where a **Global Admin** for their
tenant is signed in. They'll see a permissions screen listing what the add-in
reads (user profile, extension attributes). After they click **Accept**, they
land on a confirmation page — "Admin consent granted, you can close this tab."

## Verify

```bash
az ad sp show --id c2995f31-11e7-4882-b7a7-ef9def0a0266 --query appId -o tsv
```

If that returns the same GUID, the service principal exists in their tenant —
consent worked. If it errors with "does not exist", consent didn't complete.

## Outlook — Microsoft Graph consent

**Only needed when deploying the Outlook manifest.** Separate from `entra_sso`
above; required even if `entra_sso` is off.

Claude for Outlook reads mail and calendar through Microsoft Graph. The Graph
token stays in the user's Outlook client and is never sent to the gateway or to
Anthropic, so this consent is the same regardless of which cloud serves the
model. A Global Admin opens the URL, clicks Accept, done.

```
https://login.microsoftonline.com/organizations/v2.0/adminconsent?client_id=c2995f31-11e7-4882-b7a7-ef9def0a0266&scope=https://graph.microsoft.com/Mail.ReadWrite%20https://graph.microsoft.com/Calendars.Read%20https://graph.microsoft.com/People.Read%20https://graph.microsoft.com/User.Read%20offline_access&redirect_uri=https://pivot.claude.ai/auth/callback
```

Without this, every user hits a "Need admin approval" wall the first time
Claude tries to read mail.

**If their policy forbids consenting to a third-party app:** they can register
their own single-tenant Entra app with the same delegated Graph permissions
(Mail.ReadWrite, Calendars.Read, People.Read, User.Read, offline_access), grant
admin consent on it, and pass its client ID as `graph_client_id` when generating
the Outlook manifest. Same data flow; approval lives under their app instead of
Anthropic's.

© Anthropic · Apache-2.0 · anthropics/financial-services

Similar slash commands

All slash commands for Cloud: AWS, Azure, GCP →

From the same set116

The whole set →
manifest This Claude Code command builds an add-in XML manifest with cloud settings. Outlook uses a separate template and needs Microsoft Graph admin consent before deployment. CX Codex +1 ★ 41,441repo stars export-data The export-data command for Claude Code copies chat history, skills, and settings before a machine is rebuilt. CX Codex +1 ★ 41,441repo stars entra-app This Claude Code command explains how to register a Microsoft Entra app in your own tenant. It covers sign-in setup for Outlook, gateways, Foundry, and sovereign clouds. CX Codex +1 ★ 41,441repo stars debug debug — a command for diagnosing deployment issues with office add-ins. It triggers when connection errors occur, configurations become stale, or the add-in fails to appear in host applications. CX Codex +1 ★ 41,441repo stars bootstrap bootstrap — a command for Claude Code that builds an endpoint for dynamic configuration and MCP server management. It runs during extension startup to push user-specific settings. CX Codex +1 ★ 41,441repo stars access-policies Builds IAM-style access_policies configurations. It defines granular allow and deny rules for Microsoft 365 add-in features. CX Codex +1 ★ 41,441repo stars verify The skill tests admin scripts and commands for claude-for-msft-365-install against an isolated fake home directory. Runs when verifying changes to deployment scripts. CX Codex +1 ★ 41,441repo stars claude-for-msft-365-install The claude-for-msft-365-install Claude Code plugin configures the Claude Microsoft 365 add-in to use a cloud model. It creates a customized manifest and guides Azure admin consent. ★ 41,441repo stars

Project sponsors

Companies that keep this analytics open