# Azure DevOps

> Azure DevOps is an MCP server for cloud and infrastructure. Community Azure DevOps server for work items, repos, pull requests, pipelines and wikis. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/billg118/mcp-server-azure-devops
- **MCP Registry name:** io.github.billg118/mcp-server-azure-devops
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

Where Microsoft's own Azure DevOps MCP covers the cloud service, this community build positions itself for teams on Azure DevOps Server (on-premises), including older versions, and for features the official one lacks. Its README points cloud users to Microsoft's server first.

Authentication is chosen with an environment variable: a personal access token, Azure Identity credentials or an Azure CLI login. On-premises collections accept PAT only. You supply the organization or collection URL, optionally a default project, and the REST api-version can be overridden (default 7.1).

Internally the code is split into feature modules for work items, projects, repositories and the rest, each registering its own tool handlers. It also serves repository content through resource URIs. Run it with npx from the npm package @billg118/mcp-server-azure-devops.

## Features

- **Work item handling:** Create and update work items from natural-language requests.
- **Repos and branches:** Browse repositories, create branches and read repository content via resource URIs.
- **Pull requests:** Create and update pull requests through the assistant.
- **Pipelines and wikis:** Registry entry lists pipelines and wikis among the covered areas.
- **Three auth methods:** PAT, Azure Identity (default) or Azure CLI login.
- **On-premises support:** Works with Azure DevOps Server collections using a PAT.

## Good for

- Triage and update work items without leaving the editor
- Open a pull request from a described change
- Query repos and pipelines on an on-premises Azure DevOps Server
- Set a default project so prompts can omit it

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server-azure-devops --env AZURE_DEVOPS_ORG_URL='<AZURE_DEVOPS_ORG_URL>' --env AZURE_DEVOPS_PAT='<AZURE_DEVOPS_PAT>' -- npx -y @billg118/mcp-server-azure-devops
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server-azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@billg118/mcp-server-azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "<AZURE_DEVOPS_ORG_URL>",
        "AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server-azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@billg118/mcp-server-azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "<AZURE_DEVOPS_ORG_URL>",
        "AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server-azure-devops": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@billg118/mcp-server-azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "<AZURE_DEVOPS_ORG_URL>",
        "AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server-azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@billg118/mcp-server-azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "<AZURE_DEVOPS_ORG_URL>",
        "AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server-azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@billg118/mcp-server-azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "<AZURE_DEVOPS_ORG_URL>",
        "AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
      }
    }
  }
}
```

## FAQ

### Cloud or on-premises?

Both; the README says it is a good fit for on-premises Azure DevOps Server, and recommends Microsoft's official server for the cloud service.

### Which environment variables are required?

AZURE_DEVOPS_ORG_URL is required; PAT is needed only when the auth method is pat.

### How do I run it?

npx -y @billg118/mcp-server-azure-devops, with the env block set in your client's config.

### Does on-premises support Azure Identity?

No, the README says Azure DevOps Server supports PAT authentication only.

### How do I add Azure DevOps to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-azure-devops --env AZURE_DEVOPS_ORG_URL='<AZURE_DEVOPS_ORG_URL>' --env AZURE_DEVOPS_PAT='<AZURE_DEVOPS_PAT>' -- npx -y @billg118/mcp-server-azure-devops

### What are the best alternatives to Azure DevOps?

The closest alternatives to Azure DevOps are Azure DevOps Server (formerly TFS), Azure DevOps (ADO), Azure MCP Server, Bitbucket MCP and DevOps Agent.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Azure DevOps Server (formerly TFS)](https://ai-powered.com/mcp/azure-devops-server-formerly-tfs): Azure DevOps Server (formerly TFS) is an open-source MCP server for cloud and infrastructure.
- [Azure DevOps (ADO)](https://ai-powered.com/mcp/azure-devops-ado): Azure DevOps (ADO) is a free MCP server for cloud and infrastructure.
- [Azure MCP Server](https://ai-powered.com/mcp/azure-mcp-server): Azure MCP Server is an open-source MCP server for cloud and infrastructure.
- [Bitbucket MCP](https://ai-powered.com/mcp/bitbucket-mcp-4): Bitbucket MCP is an open-source MCP server for developer tools.
- [DevOps Agent](https://ai-powered.com/mcp/devops-agent): DevOps Agent is a freemium MCP server for cloud and infrastructure.
- [GitHub CI/CD MCP Server](https://ai-powered.com/mcp/github-ci-cd-mcp-server): GitHub CI/CD MCP Server is an open-source MCP server for developer tools.
- [Agile Analytics MCP](https://ai-powered.com/mcp/agile-analytics-mcp): Agile Analytics MCP is a paid MCP server for cloud and infrastructure.
- [Yaw Labs AWS MCP](https://ai-powered.com/mcp/yaw-labs-aws-mcp): Yaw Labs AWS MCP is an open-source MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/azure-devops
