Azure DevOps MCP Server

The Azure DevOps MCP Server enables AI models to interact with Azure DevOps, providing capabilities for managing work items, pull requests, pipelines, and more.

GitHub starsnpm versionnpm downloads

Overview

The Azure DevOps MCP Server brings Azure DevOps context to your agents, enabling AI models to interact with your Azure DevOps environment. It allows for managing work items, pull requests, test plans, builds, releases, and wiki pages directly from your code editor or AI assistant.

Official Server:

Developed and maintained by Microsoft

Key Features

📝

Work Item Management

Create, update, query, and manage work items like bugs, tasks, and user stories.

🔄

Pull Request Operations

List, create, and update pull requests, and manage their comments and threads.

🚀

Pipeline & Build Interaction

Query pipeline status and trigger new pipeline runs.

📚

Wiki Management

Create, update, and retrieve content from wiki pages.

Available Tools

Quick Reference

ToolPurposeCategory
core_list_projectsList projects in your organizationCore
wit_my_work_itemsRetrieve work items for the authenticated userWork Items
wit_create_work_itemCreate a new work itemWork Items
repo_list_repos_by_projectList repositories for a given projectRepositories
repo_create_pull_requestCreate a new pull requestRepositories
wiki_create_wiki_pageCreate a new wiki pageWiki

Detailed Usage

core_list_projects

Retrieve a list of projects in your Azure DevOps organization.

use_mcp_tool({
  server_name: "azure-devops",
  tool_name: "core_list_projects",
  arguments: {}
});
wit_create_work_item

Create a new work item in a specified project and work item type.

use_mcp_tool({
  server_name: "azure-devops",
  tool_name: "wit_create_work_item",
  arguments: {
    project: "MyProject",
    type: "Bug",
    title: "Fix authentication issue",
    description: "Users are unable to log in."
  }
});
repo_create_pull_request

Create a new pull request.

use_mcp_tool({
  server_name: "azure-devops",
  tool_name: "repo_create_pull_request",
  arguments: {
    repositoryId: "my-repo-id",
    sourceRefName: "refs/heads/feature/new-feature",
    targetRefName: "refs/heads/main",
    title: "New Feature Implementation"
  }
});
wiki_create_wiki_page

Create a new wiki page with specified content.

use_mcp_tool({
  server_name: "azure-devops",
  tool_name: "wiki_create_wiki_page",
  arguments: {
    project: "MyProject",
    wikiIdentifier: "MyWiki",
    path: "/NewPage",
    content: "# My New Wiki Page\nThis is the content of my new wiki page."
  }
});

Installation

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

Sources