Azure DevOps MCP Server

A Model Context Protocol (MCP) server for integrating with Azure DevOps, enabling AI agents to create, update, and query work items and iterations.

Features

This MCP server exposes various tools to interact with Azure DevOps:

• Work Item Management

  • Create new work items (Bug, Task, Feature, User Story, Epic)
  • Update existing work items (state, assignee, tags, custom fields)
  • Get work item details by ID (with optional relations/fields expansion)
  • List work items using filters or custom WIQL queries
  • Add comments/discussions to work items

• Iteration (Sprint) Management

  • List all iterations for a project or team
  • Create new iterations with start and finish dates
  • Delete iterations

• Pull Request Management

  • List pull requests for a specific Git repository
  • Create new pull requests with source and target branches

• Build & Pipeline Management

  • List CI/CD build definitions (pipelines)
  • Queue/trigger new build runs
  • Fetch the status and detail of a specific build run

• Repository Management

  • List Git repositories within an Azure DevOps project

• Dashboard Management

  • List dashboards for a specific project or team

• Wiki Management

  • Retrieve the content of a specific Wiki page

Installation and Usage

You can set up and use this MCP server natively within AI agents (like Claude Desktop or Cursor) using any of the following methods:

HOW TO GET ACCESS TOKEN FROM AZURE DEVOPS

1. Go to Azure DevOps User Settings at the top right corner
2. Click on "Personal access tokens" (https://dev.azure.com/your-org/_usersSettings/tokens)
3. Click on "New token" (https://dev.azure.com/your-org/_usersSettings/tokens/new)
4. Fill in the required information (Name, Organization, Expiration, Scopes)
5. Click on "Create"
6. Copy the token

Option 1: Global NPM Install (Recommended for Production)

Installing the package globally builds the project and links the azure-devops-mcp command to your system's PATH.

1. Install globally

   npm install -g @doctor-blue/azure_devops_mcp

2. Configure the client

   • Claude Code (~/.claude/code/config.json):

     {
       "mcpServers": {
         "azure-devops": {
           "command": "azure-devops-mcp",
           "args": [],
           "env": {
             "AZDO_ORG_URL": "https://dev.azure.com/your-org",
             "AZDO_PAT": "your-personal-access-token"
           }
         }
       }
     }

   • Claude Desktop (claude_desktop_config.json):

     {
       "mcpServers": {
         "azure-devops": {
           "command": "azure-devops-mcp",
           "args": [],
           "env": {
             "AZDO_ORG_URL": "https://dev.azure.com/your-org",
             "AZDO_PAT": "your-personal-access-token"
           }
         }
       }
     }

   • Antigravity (antigravity_config.json):

     {
       "mcpServers": {
         "azure-devops": {
           "command": "azure-devops-mcp",
           "args": [],
           "env": {
             "AZDO_ORG_URL": "https://dev.azure.com/your-org",
             "AZDO_PAT": "your-personal-access-token"
           }
         }
       }
     }

This method is ideal for production use since the package is installed once and available system-wide.

Option 2: Clone repo and run locally

1. Clone the repository

   git clone https://github.com/your-org/azure-devops-mcp.git
   cd azure-devops-mcp

2. Install dependencies and build

   npm install
   npm run build

3. Create a .env file in the project root with your Azure DevOps credentials:

   AZDO_ORG_URL=https://dev.azure.com/your-org
   AZDO_PAT=your-personal-access-token

4. Run the server locally

   npm run dev

5. Configure the client
   • Claude Code: add to ~/.claude/code/config.json (or appropriate config) the following:

     {
       "mcpServers": {
         "azure-devops": {
           "command": "node",
           "args": ["$(pwd)/dist/index.js"],
           "env": {
             "AZDO_ORG_URL": "${AZDO_ORG_URL}",
             "AZDO_PAT": "${AZDO_PAT}"
           }
         }
       }
     }

   • Claude Desktop: edit claude_desktop_config.json similarly:

     {
       "mcpServers": {
         "azure-devops": {
           "command": "node",
           "args": ["/full/path/to/azure-devops-mcp/dist/index.js"],
           "env": {
             "AZDO_ORG_URL": "https://dev.azure.com/your-org",
             "AZDO_PAT": "your-token"
           }
         }
       }
     }

   • Antigravity: add to its MCP configuration (e.g., antigravity_config.json):

     {
       "mcpServers": {
         "azure-devops": {
           "command": "node",
           "args": ["/full/path/to/azure-devops-mcp/dist/index.js"],
           "env": {
             "AZDO_ORG_URL": "https://dev.azure.com/your-org",
             "AZDO_PAT": "your-token"
           }
         }
       }
     }

Security

This plugin uses Personal Access Tokens (PAT) for authentication with Azure DevOps. Please treat your PATs like passwords and store them securely. Avoid committing them to version control.

License

MIT

Contributing

We welcome contributions to the Azure DevOps MCP Server plugin!

To get started:

1. Fork the repository
2. Create a new branch (git checkout -b feature/amazing-feature)
3. Make your changes and commit them (git commit -m 'feat: add amazing feature')
4. Push to your fork (git push origin feature/amazing-feature)
5. Open a Pull Request

Please ensure your code passes styling and build checks (npm run build) before submitting your PR.