# Tiberriver256/mcp-server-azure-devops [Health: Active]

**Category:** 🔄 Version Control  
**Repository:** https://github.com/Tiberriver256/mcp-server-azure-devops  
**GitHub Stars:** 388  
**npm Downloads (last month):** 18111  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/tiberriver256-mcp-server-azure-devops

## Description
Azure DevOps integration for repository management, work items, and pipelines.

## Tools
Capabilities this server exposes over MCP:

- **get_me** — Get details of the authenticated user (id, displayName, email) (Azure DevOps Services only)
- **list_organizations** — List all accessible organizations (Azure DevOps Services only)
- **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
- **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
- **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
- **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
- **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
- **get_wikis** — List all wikis in a project
- **get_wiki_page** — Get content of a specific wiki page as plain text

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `AZURE_DEVOPS_ORG_URL`, `AZURE_DEVOPS_PAT` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Tiberriver256/mcp-server-azure-devops MCP server does

Tiberriver256/mcp-server-azure-devops MCP server gives MCP-compatible assistants access to Azure DevOps APIs. It covers organization and project discovery, repository inspection and changes, work item management, code and wiki search, wiki retrieval, and pipeline operations.

The server supports both Azure DevOps Services and Azure DevOps Server deployments. Azure DevOps Services-only tools include retrieving the authenticated user and listing accessible organizations. The repository can be useful for teams that need on-premises Azure DevOps Server support, including older installations, or for workflows not covered by Microsoft's official Azure DevOps MCP server.

## How it works

The server runs as a Node.js application and communicates with an AI client through the Model Context Protocol. Feature modules organize operations for areas such as projects, work items, repositories, and pipelines. Each exposed tool sends a corresponding request to Azure DevOps and returns the result to the assistant.

Tiberriver256/mcp-server-azure-devops MCP server can read repository files and directory trees, create branches, and commit multiple file changes using unified diffs or search-and-replace instructions. It can also retrieve, create, update, list, and link work items. Pipeline tools cover discovery, run details, artifacts, timelines, logs, and triggering runs with parameters.

## Setup and configuration

The published package can be launched with `npx -y @tiberriver256/mcp-server-azure-devops`. Running from source requires Node.js 16 or newer, npm or yarn, dependency installation, a build, and the start script. Development mode is available through the repository's development script.

Set `AZURE_DEVOPS_ORG_URL` to the Azure DevOps organization URL or server collection URL. Authentication is selected with `AZURE_DEVOPS_AUTH_METHOD`, whose supported values are `pat`, `azure-identity`, and `azure-cli`; it defaults to Azure Identity. PAT authentication also requires `AZURE_DEVOPS_PAT`. `AZURE_DEVOPS_DEFAULT_PROJECT` can provide a default project when a tool call does not specify one. API version, Azure service-principal credentials, and logging can be configured with the documented optional variables.

For Claude Desktop or Cursor, configure the MCP server with the `npx` command and the required environment variables. Azure CLI authentication assumes the user has already completed `az login`.

## Tools and capabilities

Available operations include:

- Inspect the authenticated user, organizations, projects, repositories, refs, statistics, and repository contents.
- Traverse repository trees and search code across repositories in a project.
- Create branches and commits, including multiple file changes.
- Retrieve, create, update, list, search, and link work items.
- List wikis, retrieve wiki pages, and search wiki content.
- List pipelines, inspect definitions and runs, download a single artifact file as text, view timelines and logs, and trigger runs.

## Limitations and notes

Tiberriver256/mcp-server-azure-devops MCP server requires an Azure DevOps account with suitable permissions and valid credentials. Authentication failures, insufficient permissions, network problems, and configuration errors can prevent operations from succeeding.

Azure DevOps Server deployments support PAT authentication only. Azure Identity and Azure CLI authentication are documented for Azure DevOps Services. The `get_me` and `list_organizations` operations are also limited to Azure DevOps Services. The server should be evaluated against the official Microsoft Azure DevOps MCP server when working exclusively with Azure DevOps Services, especially if a product-supported implementation is preferred.

_Full upstream README: https://allmcps.com/mcp/tiberriver256-mcp-server-azure-devops/readme_