Azure DevOps MCP Server

Enables AI assistants to securely interact with Azure DevOps through a standardized protocol.

Local serverstdio★ 382

What is the Azure DevOps MCP Server?

Enables AI assistants to securely interact with Azure DevOps through a standardized protocol.

What the server does

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:

Credentials and setup notes

  • 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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_meGet details of the authenticated user (id, displayName, email) (Azure DevOps Services only)
list_organizationsList all accessible organizations (Azure DevOps Services only)
list_projectsList all projects in an organization
get_projectGet details of a specific project
get_project_detailsGet comprehensive details of a project including process, work item types, and teams
list_repositoriesList all repositories in a project
get_repositoryGet details of a specific repository
get_repository_detailsGet detailed information about a repository including statistics and refs
get_file_contentGet content of a file or directory from a repository
get_repository_treeList a repository's file tree from any path and depth
create_branchCreate a new branch from an existing one
create_commitCommit multiple file changes to a branch using unified diffs or search/replace instructions
get_work_itemRetrieve a work item by ID
create_work_itemCreate a new work item
update_work_itemUpdate an existing work item
list_work_itemsList work items in a project
manage_work_item_linkAdd, remove, or update links between work items
create_work_item_attachmentUpload and attach a file to a work item
get_work_item_attachmentDownload an attachment from a work item
delete_work_item_attachmentDelete an attachment from a work item
search_codeSearch for code across repositories in a project
search_wikiSearch for content across wiki pages in a project
search_work_itemsSearch for work items across projects in Azure DevOps
list_pipelinesList pipelines in a project
get_pipelineGet details of a specific pipeline
list_pipeline_runsList recent runs for a pipeline with optional filters
get_pipeline_runGet detailed run information and artifact summaries
download_pipeline_artifactDownload a single artifact file as text
pipeline_timelineRetrieve the stage and job timeline for a run
get_pipeline_logRetrieve raw or JSON-formatted log content
trigger_pipelineTrigger a pipeline run with customizable parameters
get_wikisList all wikis in a project
get_wiki_pageGet content of a specific wiki page as plain text

How to install the Azure DevOps MCP Server

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": [
        "-y",
        "@tiberriver256/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"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • 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
VariableDescriptionRequired
AZURE_DEVOPS_ORG_URLDeclared in the maintainer’s client configuration.Check documentation
AZURE_DEVOPS_AUTH_METHODDeclared in the maintainer’s client configuration.Check documentation
AZURE_DEVOPS_DEFAULT_PROJECTDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Azure DevOps to get me.”
  • “Use Azure DevOps to list organizations.”
  • “Use Azure DevOps to list projects.”

Frequently asked questions

The server supports Personal Access Token (PAT), Azure Identity credentials (DefaultAzureCredential), and Azure CLI authentication.