
Azure MCP Server: Setup for Claude Code, Cursor and Other Apps
Lets your assistant look up and manage resources in your Azure account, from storage and databases to App Service and monitoring.
This is Microsoft's Azure server, covering more than 45 Azure services in one install. It runs on your computer and uses the Azure account you are already signed in with, so it can do what your Azure permissions allow. That includes deleting virtual machines and other resources, so start it in read-only mode and give your account only the roles you need.
Good for
- Azure developers who want Copilot, Claude or Cursor to find and inspect resources
- Cloud engineers who check logs, metrics and settings from the chat
- Teams that want read-only Azure answers without opening the portal
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Azure MCP
Claude Code
- 1
Copy this prompt.
Add the Azure MCP server to Claude Code. Run this command: claude mcp add azure-mcp-server -- npx -y @azure/mcp@latest server start Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js, Azure sign-in (az login).
Read-only mode: Add --read-only after "server start" in the command.
The command must end with server start. Without it, the package does not start the MCP server. Sign in with az login first. Add --read-only after start to block changes.
From the project README. Source.
Tools
Lists your resource groups
Lists the resource groups in a subscription.
Try: “List the resource groups in my subscription.”
Network ·
azmcp group listLists the resources in a group
Lists everything inside one resource group.
Try: “What is in the resource group my-rg?”
Network ·
azmcp group resource listLists your storage accounts
Lists the Azure Storage accounts in a subscription.
Try: “List my Azure Storage accounts.”
Network ·
azmcp storage account listLists Cosmos DB accounts
Lists Cosmos DB accounts in a subscription.
Try: “Which Cosmos DB accounts do I have?”
Network ·
azmcp cosmos listQueries items in a Cosmos DB container
Runs a query against items in a Cosmos DB container.
Try: “Query the orders container for items from today.”
Network ·
azmcp cosmos database container item queryShows App Service web apps
Gets details of web apps in a subscription or resource group.
Try: “Show details of my web app.”
Network ·
azmcp appservice webapp getChanges web app settings
Updates app settings on an App Service web app.
Try: “Add the setting LOG_LEVEL=debug to my web app.”
Write ·
azmcp appservice webapp settings update-appsettingsStarts, stops or restarts a web app
Changes the running state of an App Service web app.
Try: “Restart my web app.”
Write ·
azmcp appservice webapp change-stateShows Kubernetes clusters
Gets details of Azure Kubernetes Service clusters.
Try: “Show my AKS clusters.”
Network ·
azmcp aks cluster getReads a Key Vault secret
Gets a secret from an Azure Key Vault.
Try: “Get the secret db-password from my vault.”
Network ·
azmcp keyvault secret getCreates a Key Vault secret
Stores a new secret in an Azure Key Vault.
Try: “Create a secret api-key in my vault.”
Write ·
azmcp keyvault secret createReads Azure Monitor metrics
Queries metrics for a resource.
Try: “Show CPU usage for my VM over the last 24 hours.”
Network ·
azmcp monitor metrics querySearches resource logs
Runs a query against logs for a resource.
Try: “Find errors in the logs for this resource.”
Network ·
azmcp monitor resource log queryLooks up Bicep resource schemas
Gets the Bicep schema for a resource type.
Try: “Show the Bicep schema for a storage account.”
Network ·
azmcp bicepschema getDeletes a virtual machine
Deletes an Azure virtual machine.
Try: “Delete the VM test-vm-01.”
Delete ·
azmcp compute vm deleteDeletes an Event Hub
Deletes an Event Hub from a namespace.
Try: “Delete the Event Hub old-events.”
Delete ·
azmcp eventhubs eventhub delete
From the official docs
Permissions
high risk · 4 things to watch · 1 advisory
High risk
It can create, change and delete real Azure resources, limited only by the roles on your account. Turn on read-only mode and use an account with the least access that gets the job done.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
It can delete VMs, disks and other resources
The command reference lists delete commands for virtual machines, disks, Event Hubs and more. Use read-only mode unless you need changes.
It can read and create Key Vault secrets
Secret values pass through the assistant. Limit Key Vault access on the account you use.
The README warns about destructive actions
Microsoft says autonomous or misconfigured clients may do destructive things and asks you to apply least-privilege roles first.
Telemetry is on by default
The README says usage data goes to Microsoft unless you turn telemetry off as described there.
Security advisories
Technical details
| Turning on read-only | Start the server with the --read-only flag. |
|---|---|
| Talks to | Azure APIs. Microsoft (telemetry is on by default and can be turned off) |
| Scopes |
|
Questions
Is the Azure MCP server official?
Yes. Microsoft publishes it in its open-source MCP repository.
Does it need an API key?
No. It uses your Azure sign-in, so run az login first. What it can do depends on your Azure roles.
Can I run it read-only?
Yes. Start the server with the --read-only flag. The README says some safeguards like this are not standard in MCP, so not every app handles them the same way.
Which apps does it work with?
The README gives setup for VS Code, Visual Studio, IntelliJ, Eclipse, Claude Code, GitHub Copilot CLI and others. Any app that can start a local server should work.
Does it run on my computer or in the cloud?
It runs on your computer. You can also host it yourself as a remote server on Azure Container Apps, which the README covers.
Does it support Azure China or US Government?
Yes. Start it with the --cloud option or set the AZURE_CLOUD variable. Sign in to that cloud first.
Does the tool list on this page show every tool?
No. It shows 16 example commands out of the hundreds in Microsoft's command reference, so it is a partial list. The names are command paths such as azmcp storage account list, not the tool names your app shows. The server groups tools by Azure service, so what your assistant sees depends on your version and settings.
Information
updated Nov 2, 2026
- Publisher
- Microsoft (official)
- Package
@azure/mcp- Registry
- npm
- Transport
- stdio
- Version
- 3.0.0-beta.48
- License
- MIT
- Last commit
- Oct 30, 2026
- Open issues
- 231
- Listed in
- Official MCP registry
Other Microsoft Azure MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- Azure MCP Server README · github.com
- Azure MCP command reference · github.com