Azure DevOps MCP

At a glance

Microsoft maintains this server for Azure DevOps. The model can list projects and teams, read and update work items, look at iterations and team capacity, browse repositories and pull requests, check and start pipeline runs, read and write wiki pages, search code and work items, and work with test plans and Advanced Security alerts.

There are two versions. Microsoft now recommends its hosted server at mcp.dev.azure.com, which needs no install and gets new tools first; this local npx package remains supported for clients that need stdio. Both need a work or school account backed by Microsoft Entra ID, since personal Microsoft accounts are not supported.

Made by

Microsoft

Licence

MIT

Latest version

2.11.0 (22 Oct 2026)

npm package

@azure-devops/mcp

GitHub stars

2.1K

Last commit

23 Oct 2026

Tools

44

Runs on

Your computer or hosted

Our check: We ran this exact config on 27 Oct 2026: it started and answered with 44 tools. The shared database gave only the hosted address with a placeholder bearer token. The hosted server signs in with your Microsoft account, and the local package is @azure-devops/mcp on npm.

What's in the pod: its tools

We found 44 tools when we started it on 27 Oct 2026. 25 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.

Grouped and described by us. The README on GitHub lists the inputs each tool takes.

Set it up

Pick your app for the exact snippet and where it goes.

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@azure-devops/mcp",
        "YOUR_ORGANIZATION"
      ]
    }
  }
}

claude mcp add-json azure-devops '{"command":"npx","args":["-y","@azure-devops/mcp","YOUR_ORGANIZATION"]}'

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@azure-devops/mcp",
        "YOUR_ORGANIZATION"
      ]
    }
  }
}

{
  "servers": {
    "azure-devops": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@azure-devops/mcp",
        "YOUR_ORGANIZATION"
      ]
    }
  }
}

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@azure-devops/mcp",
        "YOUR_ORGANIZATION"
      ]
    }
  }
}

Replace YOUR_ORGANIZATION with the name in your dev.azure.com address. Add "-d", "core", "work", "work-items" to load only some tool groups. It signs in through a browser by default; use "--authentication", "azcli" or "pat" on machines without one.

Remote option

Microsoft's recommended hosted server, in preview. Replace the last part with your organization name and sign in with your Microsoft account.

https://mcp.dev.azure.com/YOUR_ORGANIZATION

New to this? See the setup guides for Claude Code, Cursor, Claude Desktop and ChatGPT.

Settings

Names are exactly as the project spells them. Required ones are marked.

What it can touch

Safer setup: Load only the domains you need with -d, and sign in as an account whose Azure DevOps permissions match what you want the model to do.

Before you start

• An Azure DevOps organization
• A Microsoft Entra ID work or school account
• Node.js 20 or newer, for the local version

If it does not work

Sign-in hangs in WSL, SSH sessions, containers or CI

The default browser sign-in needs a browser. Use --authentication azcli after az login, or envvar or pat with a token.

TF400813: the user is not authorized

You are probably signed in to the wrong tenant. Pass --tenant with your organization's tenant ID.

A personal Microsoft account is rejected

Only Entra ID work or school accounts are supported.

The client warns about too many tools

Pass -d with only the domains you need, such as core work work-items.

Peas in a pod: similar servers

How Azure DevOps MCP lines up against other cloud and operations servers on the shelf.

Questions

Something wrong on this page? Tell us.