by microsoft · microsoft/azure-devops-mcp
Microsoft-built MCP that exposes Azure DevOps — work items, repos, pipelines, boards — to Claude with PAT auth.
Official Azure DevOps MCP. Read/write work items, browse repos, inspect pipelines, manage boards. Mirrors the surface of the GitHub MCP for Azure DevOps users.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"azure-devops-mcp": {
"command": "npx",
"args": [
"-y",
"@microsoft/azure-devops-mcp"
],
"env": {
"AZURE_DEVOPS_PAT": "${AZDO_PAT}",
"AZURE_DEVOPS_ORG": "${AZDO_ORG}"
}
}
}
}Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.
{
"mcpServers": {
"azure-devops-mcp": {
"command": "npx",
"args": [
"-y",
"@microsoft/azure-devops-mcp"
],
"env": {
"AZURE_DEVOPS_PAT": "${AZDO_PAT}",
"AZURE_DEVOPS_ORG": "${AZDO_ORG}"
}
}
}
}Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.
{
"mcpServers": {
"azure-devops-mcp": {
"command": "npx",
"args": [
"-y",
"@microsoft/azure-devops-mcp"
],
"env": {
"AZURE_DEVOPS_PAT": "${AZDO_PAT}",
"AZURE_DEVOPS_ORG": "${AZDO_ORG}"
}
}
}
}Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".
{
"mcpServers": {
"azure-devops-mcp": {
"command": "npx",
"args": [
"-y",
"@microsoft/azure-devops-mcp"
],
"env": {
"AZURE_DEVOPS_PAT": "${AZDO_PAT}",
"AZURE_DEVOPS_ORG": "${AZDO_ORG}"
}
}
}
}Same shape as Claude Desktop. Restart Windsurf to pick up changes.
{
"mcpServers": [
{
"name": "azure-devops-mcp",
"command": "npx",
"args": [
"-y",
"@microsoft/azure-devops-mcp"
]
}
]
}Continue uses an array of server objects rather than a map.
{
"context_servers": {
"azure-devops-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@microsoft/azure-devops-mcp"
]
}
}
}
}Add to context_servers. Zed hot-reloads on save.
claude mcp add azure-devops-mcp -- npx -y @microsoft/azure-devops-mcpOne-liner. Verify with claude mcp list. Remove with claude mcp remove.
When to use: Sprint planning; you want a Claude-assisted pass over the backlog.
Outcome: Backlog triage done with audit trail in ADO.
Cross-link GH PRs with ADO work items
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| list_work_items | (see docs) | Query WIs with filters | 1 call |
| update_work_item | (see docs) | Patch a WI | 1 call |
| list_pipelines | (see docs) | Pipelines in a project | 1 call |
| retry_pipeline | (see docs) | Retry failed pipeline | 1 call |
vso.work vso.codevso.*_manage scopes unless required401PAT expired or wrong scopes
Project not foundUse the exact project name including casing
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| gitlab-mcp-zereight | You're on GitLab | Different platform |