Azure DevOps

This MCP server enables Cursor IDE to interact with Azure DevOps, giving you access to projects, work items, repositories, pull requests, and test management. Use it to power AI-assisted workflows, retrieve and summarize Azure DevOps data, and manage comments, changes, and test plans from within your development environment.

How to use

Install and run the MCP server locally or connect via a configured MCP client in Cursor. Once the server is running, you can perform common Azure DevOps operations through the MCP tools, such as listing projects, fetching work items, viewing pull requests and their threads, and managing test plans and suites. Use the provided tools to query data, view details, and attach or comment on pull requests or work items as part of your AI-assisted workflows.

Practical usage patterns include: selecting a default project for convenient access, then listing related items (projects, work items, repos). Retrieve detailed changes for pull requests, and interact with comments to add or reply to discussions. When working with test management, list plans, suites, and cases to generate summaries or updates for your teammates.

How to install

Prerequisites: Node.js and npm or npx installed on your system. Ensure you have the necessary permissions to install global packages if you plan to run the MCP server globally.

Global installation (recommended if you want to run the MCP server from anywhere):

npm install -g cursor-azure-devops-mcp

Local installation (preferred for project-local usage):

npm install cursor-azure-devops-mcp

Configuration and usage notes

You can configure the server using command line arguments, IDE settings, or environment variables. The recommended first approach is to run the server directly with npx for quick testing, then configure Cursor IDE to connect to the MCP server.

MCP server configuration (example)

{
  "mcpServers": {
    "azure_devops": {
      "type": "stdio",
      "command": "cmd",
      "args": ["/c","npx","cursor-azure-devops-mcp","--azure-org-url","https://dev.azure.com/your-organization","--azure-token","your-personal-access-token","--azure-project","your-project"]
    }
  }
}

Environment variables

Set credentials and configuration through environment variables or a .env file. Common variables include the organization URL, access token, and the default project.

Usage in Cursor IDE

Open Cursor IDE and connect to the MCP server via Command Mode (recommended) or SSE Mode if available. In Command Mode, specify the command to start the MCP server (for example, running the server process directly). Ensure your credentials are available in the environment or in a .env file in your working directory.

Additional configuration and notes

The server supports a default project from configuration and provides robust error handling for missing project information. Large responses are truncated to fit AI model limits while preserving essential fields and metadata about truncation.

Available tools

azure_devops_projects

Get all projects in Azure DevOps.

azure_devops_work_item

Get a specific work item by ID.

azure_devops_work_items

Get multiple work items by IDs.

azure_devops_repositories

List repositories in a project.

azure_devops_pull_requests

Get pull requests for a repository.

azure_devops_pull_request_by_id

Get a specific pull request by repository and ID.

azure_devops_pull_request_threads

Get threads for a pull request.

azure_devops_work_item_attachments

Get attachments for a work item.

azure_devops_work_item_comments

Get comments for a work item.

azure_devops_pull_request_changes

Get detailed code changes for a pull request.

azure_devops_pull_request_file_content

Get content of a file in a pull request.

azure_devops_branch_file_content

Get file content directly from a branch.

azure_devops_create_pr_comment

Create a comment on a pull request.

azure_devops_test_plans

List all test plans for a project.

azure_devops_test_plan

Get a test plan by ID.

azure_devops_test_suites

List all test suites for a test plan.

azure_devops_test_suite

Get a test suite by ID.

azure_devops_test_cases

List all test cases for a test suite.