home / mcp / azure devops mcp server

Azure DevOps MCP Server

Provides a comprehensive MCP server to manage Azure DevOps work items, boards, repos, and more via a unified API.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ryancardin15-azuredevops-mcp": {
      "command": "npx",
      "args": [
        "@ryancardin/azuredevops-mcp-server@latest"
      ],
      "env": {
        "ALLOWED_TOOLS": "listWorkItems,getWorkItemById,searchWorkItems",
        "AZURE_DEVOPS_DOMAIN": "your-domain",
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_PROJECT": "your-project",
        "AZURE_DEVOPS_PASSWORD": "your-password",
        "AZURE_DEVOPS_USERNAME": "your-username",
        "AZURE_DEVOPS_AUTH_TYPE": "pat",
        "AZURE_DEVOPS_COLLECTION": "DefaultCollection",
        "AZURE_DEVOPS_API_VERSION": "6.0",
        "AZURE_DEVOPS_IS_ON_PREMISES": "false",
        "AZURE_DEVOPS_PERSONAL_ACCESS_TOKEN": "your-personal-access-token"
      }
    }
  }
}

The Azure DevOps MCP Server provides a unified API to interact with Azure DevOps services—work items, boards, repos, projects, sprints, and more—via the Model Context Protocol. This enables AI assistants and other tools to manage and query your Azure DevOps data in a consistent, programmatic way.

How to use

You run the MCP server locally or remotely and connect your MCP client to it. Once connected, you can list, create, update, and query work items; browse boards and sprints; manage projects and iterations; work with repositories and pull requests; run tests and DevSecOps checks; handle artifacts; and leverage AI-assisted development features. Use each tool by calling its operation name and providing the required parameters. Combine multiple tools in a single workflow to automate end-to-end DevOps tasks.

How to install

Prerequisites: ensure you have Node.js installed (v16 or later) and have an Azure DevOps account with a Personal Access Token (PAT) or appropriate credentials.

npx @ryancardin/azuredevops-mcp-server@latest

Configuration and usage notes

Configure environment variables to connect to your Azure DevOps organization, choose authentication, and set your default project. You can tailor which tools are enabled by using the ALLOWED_TOOLS setting. You can also run the server with a local setup or as a remote service.

Key environment variables you will set include the organization URL, project, authentication type, and PAT. If you are using on-premises Azure DevOps Server, provide the collection and API version where required.

Available tools

listWorkItems

List work items using queries to retrieve items matching specific criteria.

getWorkItemById

Fetch details for a work item by its ID.

searchWorkItems

Search for work items using keywords or WIQL queries.

getRecentlyUpdatedWorkItems

Retrieve work items recently updated.

getAssignedWorkItems

Get work items assigned to you.

createWorkItem

Create a new work item with a given type, title, and description.

updateWorkItem

Update properties of an existing work item.

addCommentToWorkItem

Add a comment to a specific work item.

updateWorkItemState

Change the state of a work item (e.g., Active, Closed).

assignWorkItem

Assign a work item to a user.

createLinksBetweenWorkItems

Create relationships between work items (e.g., blockers, related items).

bulkCreateUpdateWorkItems

Bulk create or update multiple work items in one operation.

getTeamBoards

List teams' boards within a project.

getBoardColumns

Retrieve columns for a specific board.

getBoardItems

List items on a board or in a column.

moveCardsOnBoards

Move cards between columns on a board.

getSprints

Get available sprints for a project.

getCurrentSprint

Fetch the current active sprint.

getSprintWorkItems

List work items in a specific sprint.

getSprintCapacity

Retrieve capacity planning for a sprint.

getTeamMembers

Get members of a project team.

listProjects

List all projects in the organization.

getProjectDetails

Get detailed information about a project.

createProjects

Create a new project.

getAreas

Get area paths within a project.

getIterations

Get iterations for a project.

createAreas

Create new area paths.

createIterations

Create new iterations within a project.

getProcessTemplates

Retrieve available process templates.

getWorkItemTypes

List work item types for a project.

getWorkItemTypeFields

Get fields for a specific work item type.

listRepositories

List Git repositories in a project.

getRepositoryDetails

Get details for a repository.

createRepositories

Create a new repository.

listBranches

List branches in a repository.

searchCode

Search code across repositories.

browseRepositories

Browse repository contents.

getFileContent

Get the contents of a file in a repository.

getCommitHistory

Retrieve commit history for a repository.

listPullRequests

List pull requests in a repository.

createPullRequests

Create a new pull request.

getPullRequestDetails

Get details for a pull request.

getPullRequestComments

Get comments on a pull request.

approvePullRequests

Approve a pull request.

mergePullRequests

Merge a pull request.

runAutomatedTests

Run automated tests for a project or build.

getTestAutomationStatus

Check the status of test automation.

configureTestAgents

Configure test agents for environments.

createTestDataGenerators

Create data generators for automated tests.

manageTestEnvironments

Manage test environments and configurations.

getTestFlakinessAnalysis

Analyze test flakiness across runs.

getTestGapAnalysis

Identify gaps in test coverage.

runTestImpactAnalysis

Analyze impact of code changes on tests.

getTestHealthDashboard

Access a dashboard showing test health metrics.

runTestOptimization

Optimize test selection and execution.

createExploratorySessions

Create exploratory testing sessions.

recordExploratoryTestResults

Record results from exploratory testing.

convertFindingsToWorkItems

Convert exploratory findings into work items.

getExploratoryTestStatistics

Retrieve statistics for exploratory testing.

getAIPoweredCodeReviews

Obtain AI-powered code reviews.

suggestCodeOptimizations

Suggest optimizations to improve code quality.

identifyCodeSmells

Identify code smells in the codebase.

getPredictiveBugAnalysis

Predict potential bugs using historical data.

getDeveloperProductivityMetrics

Gather metrics on developer productivity.

getPredictiveEffortEstimations

Estimate effort for work items and tasks.

getCodeQualityTrends

Track trends in code quality over time.

suggestWorkItemRefinements

Suggest refinements for work items.

suggestAutomationOpportunities

Identify opportunities to automate repetitive tasks.

createIntelligentAlerts

Set up intelligent alerts based on events.

predictBuildFailures

Forecast potential build failures.

optimizeTestSelection

Optimize which tests to run for a given change.