Azure DevOps

Name: Azure DevOps
Author: billg118

by billg118version 0.1.54i★ –iRuns on your computer

Registry nameio.github.billg118/mcp-server-azure-devops

Install

Overview

Description from the maker (original English)

Azure DevOps MCP server: projects, repos, work items, pull requests, pipelines, and wikis.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Developer tools
You need to fill in: AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_PAT

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_AUTH_METHOD, AZURE_DEVOPS_PAT, AZURE_DEVOPS_DEFAULT_PROJECT

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@billg118/mcp-server-azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "your-value",
        "AZURE_DEVOPS_AUTH_METHOD": "your-value",
        "AZURE_DEVOPS_PAT": "your-value",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add azure-devops --env AZURE_DEVOPS_ORG_URL=your-value --env AZURE_DEVOPS_AUTH_METHOD=your-value --env AZURE_DEVOPS_PAT=your-value --env AZURE_DEVOPS_DEFAULT_PROJECT=your-value -- npx -y @billg118/mcp-server-azure-devops

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@billg118/mcp-server-azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "your-value",
        "AZURE_DEVOPS_AUTH_METHOD": "your-value",
        "AZURE_DEVOPS_PAT": "your-value",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "azure-devops": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@billg118/mcp-server-azure-devops"
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "your-value",
        "AZURE_DEVOPS_AUTH_METHOD": "your-value",
        "AZURE_DEVOPS_PAT": "your-value",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

AZURE_DEVOPS_ORG_URL required env
Azure DevOps organization URL, e.g. https://dev.azure.com/your-organization
AZURE_DEVOPS_AUTH_METHOD env
Authentication method: 'pat', 'azure-identity' (default), or 'azure-cli'
AZURE_DEVOPS_PAT secret env
Personal Access Token (required when AZURE_DEVOPS_AUTH_METHOD is 'pat')
AZURE_DEVOPS_DEFAULT_PROJECT env
Default project to use when none is specified

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account billg118, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Developer toolsi

More stars than 0% of the other 1395 servers in this category
Published to the registry more recently than 94% of the other 1395 servers in this category
Basic checks equal to or better than 100% of the other 1395 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Azure DevOps safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_PAT

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.54) reached the registry 2 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: GitHub, Desktop Commander, Cloudflare MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitHub

by github

GitHub’s official server lets AI read and manage code, issues and pull requests in your account. Use GitHub’s hosted version or run it locally with Docker.

Computer or cloud★ 34,245MITUpdated 4 days ago

Install

Desktop Commander

by wonderwhy-er

MCP server for terminal commands, file operations, and process management

Runs on your computer★ 10,225MITUpdated 16 days ago

Install

Cloudflare MCP

by cloudflare

Cloudflare MCP servers

Runs in the cloud★ 4,446Apache-2.0Updated 14 months ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Azure DevOps MCP Server

A Model Context Protocol (MCP) server implementation for Azure DevOps, allowing AI assistants to interact with Azure DevOps APIs through a standardized protocol.

Looking for the official server? Microsoft maintains a product-supported Azure DevOps MCP at microsoft/azure-devops-mcp. If you use Azure DevOps Services (cloud), start there.

This community server remains a good fit when you need Azure DevOps Server (on-premises) support — especially older versions that may not work with Microsoft's MCP — or features not yet available in the official server. See Discussion #237 for more context. See ROADMAP.md for where this server differentiates and what is planned.

Overview

This server implements the Model Context Protocol (MCP) for Azure DevOps, enabling AI assistants like Claude to interact with Azure DevOps resources securely. The server acts as a bridge between AI models and Azure DevOps APIs, providing a standardized way to:

Access and manage projects, work items, repositories, and more
Create and update work items, branches, and pull requests
Execute common DevOps workflows through natural language
Access repository content via standardized resource URIs
Safely authenticate and interact with Azure DevOps resources

Server Structure

The server is structured around the Model Context Protocol (MCP) for communicating with AI assistants. It provides tools for interacting with Azure DevOps resources including:

Projects
Work Items
Repositories
Pull Requests
Branches
Pipelines

Core Components

AzureDevOpsServer: Main server class that initializes the MCP server and registers tools
Feature Modules: Organized by feature area (work-items, projects, repositories, etc.)
Request Handlers: Each feature module provides request identification and handling functions
Tool Handlers: Modular functions for each Azure DevOps operation
Configuration: Environment-based configuration for organization URL, PAT, etc.

The server uses a feature-based architecture where each feature area (like work-items, projects, repositories) is encapsulated in its own module. This makes the codebase more maintainable and easier to extend with new features.

Getting Started

Prerequisites

Node.js (v16+)
npm or yarn
Azure DevOps account with appropriate access
Authentication credentials (see Authentication Guide for details):
Personal Access Token (PAT), or
Azure Identity credentials, or
Azure CLI login

Running from npm (npx)

If you just want to run the published server package, you do not need to clone or build this repository:

npx -y @billg118/mcp-server-azure-devops

Running locally (from source)

From a checkout of this repository:

npm ci

cp .env.example .env # then edit values npm run build npm start # runs: node dist/index.js

For iterative development (auto-reload):

npm run dev            # runs src/index.ts via tsx watch

Usage with Claude Desktop/Cursor AI

To integrate with Claude Desktop or Cursor AI, add one of the following configurations to your configuration file.

Azure Identity Authentication

Be sure you are logged in to Azure CLI with az login then add the following:

"mcpServers": { "azureDevOps": { "command": "npx", "args": ["-y", "@billg118/mcp-server-azure-devops"], "env": { "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization", "AZURE_DEVOPS_AUTH_METHOD": "azure-identity", "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name" } } } }

Personal Access Token (PAT) Authentication

"mcpServers": { "azureDevOps": { "command": "npx", "args": ["-y", "@billg118/mcp-server-azure-devops"], "env": { "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization", "AZURE_DEVOPS_AUTH_METHOD": "pat", "AZURE_DEVOPS_PAT": " ", "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name" } } } }

Azure DevOps Server (on-prem) requires PAT authentication. Example:

"mcpServers": { "azureDevOps": { "command": "npx", "args": ["-y", "@billg118/mcp-server-azure-devops"], "env": { "AZURE_DEVOPS_ORG_URL": "https://server:8080/tfs/DefaultCollection", "AZURE_DEVOPS_AUTH_METHOD": "pat", "AZURE_DEVOPS_PAT": " ", "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name" } } } }

For detailed configuration instructions and more authentication options, see the Authentication Guide.

Authentication Methods

This server supports multiple authentication methods for connecting to Azure DevOps APIs. For detailed setup instructions, configuration examples, and troubleshooting tips, see the Authentication Guide.

Supported Authentication Methods

Personal Access Token (PAT) - Simple token-based authentication
Azure Identity (DefaultAzureCredential) - Flexible authentication using the Azure Identity SDK
Azure CLI - Authentication using your Azure CLI login

Example configuration files for each authentication method are available in the examples directory.

Azure DevOps Server (on-prem) supports PAT authentication only. Azure Identity and Azure CLI are supported for Azure DevOps Services.

Environment Variables

For a complete list of environment variables and their descriptions, see the Authentication Guide.

Key environment variables include:

Variable	Description	Required	Default
`AZURE_DEVOPS_AUTH_METHOD`	Authentication method (`pat`, `azure-identity`, or `azure-cli`) - case-insensitive	No	`azure-identity`
`AZURE_DEVOPS_ORG_URL`	Full URL to your Azure DevOps organization or Server collection (e.g., `https://server:8080/tfs/DefaultCollection`)	Yes	-
`AZURE_DEVOPS_PAT`	Personal Access Token (for PAT auth)	Only with PAT auth	-
`AZURE_DEVOPS_DEFAULT_PROJECT`	Default project if none specified	No	-
`AZURE_DEVOPS_API_VERSION`	REST api-version for the tools that call the REST API directly (per-release values)	No	`7.1`
`AZURE_TENANT_ID`	Azure AD tenant ID (for service principals)	Only with service principals	-
`AZURE_CLIENT_ID`	Azure AD application ID (for service principals)	Only with service principals	-
`AZURE_CLIENT_SECRET`	Azure AD client secret (for service principals)	Only with service principals	-
`LOG_LEVEL`	Logging level (debug, info, warn, error)	No	info

Troubleshooting Authentication

For detailed troubleshooting information for each authentication method, see the Authentication Guide.

Common issues include:

Invalid or expired credentials
Insufficient permissions
Network connectivity problems
Configuration errors

Authentication Implementation Details

For technical details about how authentication is implemented in the Azure DevOps MCP server, see the Authentication Guide and the source code in the src/auth directory.

Available Tools

The Azure DevOps MCP server provides a variety of tools for interacting with Azure DevOps resources. For detailed documentation on each tool, please refer to the corresponding documentation.

Organization Tools

list_organizations: List all accessible organizations (Azure DevOps Services only)

Project Tools

list_projects: List all projects in an organization
get_project: Get details of a specific project
get_project_details: Get comprehensive details of a project including process, work item types, and teams

Repository Tools

list_repositories: List all repositories in a project
get_repository: Get details of a specific repository
get_repository_details: Get detailed information about a repository including statistics and refs
get_file_content: Get content of a file or directory from a repository
get_repository_tree: List a repository's file tree from any path and depth
create_branch: Create a new branch from an existing one
create_commit: Commit multiple file changes to a branch using unified diffs or search/replace instructions

Work Item Tools

get_work_item: Retrieve a work item by ID
create_work_item: Create a new work item
update_work_item: Update an existing work item
list_work_items: List work items in a project
manage_work_item_link: Add, remove, or update links between work items
create_work_item_attachment: Upload and attach a file to a work item
get_work_item_attachment: Download an attachment from a work item
delete_work_item_attachment: Delete an attachment from a work item

Search Tools

search_code: Search for code across repositories in a project
search_wiki: Search for content across wiki pages in a project
search_work_items: Search for work items across projects in Azure DevOps

Pipelines Tools

list_pipelines: List pipelines in a project
get_pipeline: Get details of a specific pipeline
list_pipeline_runs: List recent runs for a pipeline with optional filters
get_pipeline_run: Get detailed run information and artifact summaries
download_pipeline_artifact: Download a single artifact file as text
pipeline_timeline: Retrieve the stage and job timeline for a run
get_pipeline_log: Retrieve raw or JSON-formatted log content
trigger_pipeline: Trigger a pipeline run with customizable parameters

Wiki Tools

get_wikis: List all wikis in a project
get_wiki_page: Get content of a specific wiki page as plain text

Pull Request Tools

create_pull_request - Create a new pull request
get_pull_request - Get a pull request by I

Only the beginning is shown; read the rest in the repo

Azure DevOps

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Developer toolsi

Common questions

Alternatives

GitHub

Desktop Commander

Cloudflare MCP

README from the maker

Azure DevOps MCP Server

Overview

Server Structure

Core Components

Getting Started

Prerequisites

Running from npm (npx)

Running locally (from source)

Usage with Claude Desktop/Cursor AI

Azure Identity Authentication

Personal Access Token (PAT) Authentication

Authentication Methods

Supported Authentication Methods

Environment Variables

Troubleshooting Authentication

Authentication Implementation Details

Available Tools

User Tools

Organization Tools

Project Tools

Repository Tools

Work Item Tools

Search Tools

Pipelines Tools

Wiki Tools

Pull Request Tools