Azure DevOps

You can seamlessly connect Azure DevOps with your AI assistant by running an MCP (Model Context Protocol) server that exposes work item, pull request, and wiki interactions. This server lets you create, list, and read work items, manage pull requests and comments, and edit wiki pages from your assistant, enabling productive automation and efficient collaboration across your Azure DevOps projects.

How to use

Start the Azure DevOps MCP Server locally and connect it to your MCP client. You will run a local MCP instance that exposes commands for work items, pull requests, and wiki pages. Your MCP client can then issue requests to list, get, or create items, PRs, and wiki pages as part of your conversational workflows.

To begin, install dependencies, build the server, and then configure your MCP client with the provided runtime command. You will typically run the server via a Node command and supply environment variables that point to your Azure DevOps organization, project, repository, and an access token.

Once the server is running, you can use the available tools to:

• List, get, and create work items in your Azure DevOps project
• List, get, and create pull requests, add comments, and view diffs
• Create and edit wiki pages for your project Integrate these capabilities into your assistant’s prompts to automate common Azure DevOps workflows.

How to install

npm install

# Create a .env file with your Azure DevOps settings
AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
AZURE_DEVOPS_PAT=your-personal-access-token
AZURE_DEVOPS_PROJECT=default-project
AZURE_DEVOPS_REPOSITORY=default-repo

# Build the server
npm run build

# Start the server (via the recommended MCP runtime configuration shown below in the installation step)

Configuration for running with an MCP client

// VSCode/macOS/Linux configuration example
{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/path/to/azure-devops-mcp/build/index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "your-org-url",
        "AZURE_DEVOPS_PAT": "your-pat",
        "AZURE_DEVOPS_PROJECT": "your-project",
        "AZURE_DEVOPS_REPOSITORY": "your-repo"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Windows configuration example

// Windows configuration example
{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["C:/path/to/azure-devops-mcp/build/index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "your-org-url",
        "AZURE_DEVOPS_PAT": "your-pat",
        "AZURE_DEVOPS_PROJECT": "your-project",
        "AZURE_DEVOPS_REPOSITORY": "your-repo"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available tools

list_work_items

List work items in a project with optional filtering by types, states, and assignee.

get_work_item

Retrieve details of a specific work item by its ID.

create_work_item

Create a new work item with a specified type, title, and optional description and assignee.

list_pull_requests

List pull requests for a repository with optional status filtering.

get_pull_request

Get details of a specific pull request by its ID.

create_pull_request

Create a new pull request with title, description, source and target branches, and optional reviewers.

create_pull_request_comment

Add a comment to a pull request with optional threading and file context.

get_pull_request_diff

Fetch the diff for a pull request with optional file and iteration filters.

create_wiki_page

Create a new page in a wiki with content.

edit_wiki_page

Edit an existing wiki page with new content and an etag for concurrency control.