Spark
Sign In
MCP Connector

Manage Azure DevOps Work Items via Natural Language

MCP server bridging AI assistants to Azure DevOps work items, projects, and teams via natural language - now unmaintained, official server recommended.

Connect
Works with azure devops
Vortiago
Own this? Claim it

Maintainer of this project? Claim this page to edit the listing.

91
Spark score
out of 100
Updated 9 months ago
Fresher alternatives ↓
Version 1.0.0
Models
universal
Add to Favorites

Why it matters

Interact with Azure DevOps services using natural language. This asset bridges the gap between AI assistants and the Azure DevOps REST API, enabling management of work items, projects, and teams.

Outcomes

What it gets done

01

Query work items using WIQL

02

Create, update, and comment on work items

03

Retrieve project and team information

04

Manage parent-child relationships for work items

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-azure-devops | bash

Capabilities

Tools your agent gets

query_work_items

Query work items using WIQL queries to find tasks, bugs, and user stories.

get_work_item

Retrieve detailed information about a specific work item.

create_work_item

Create new work items such as tasks, bugs, or user stories.

update_work_item

Update work item fields and properties.

add_work_item_comment

Add comments to work items.

get_work_item_comments

View comment history for work items.

manage_work_item_relations

Manage parent-child relationships between work items.

list_projects

Retrieve projects in an Azure DevOps organization.

+2 tools

Overview

Azure DevOps MCP Server

An MCP server that lets AI assistants search, create, and update Azure DevOps work items and inspect project/team/iteration structure via natural language, backed by the Azure DevOps REST API. Pipeline, pull request, sprint-management, and branch-policy features are planned but not yet built. Use for existing Azure DevOps work item and project automation needs, but note the repository is unmaintained - Microsoft's official azure-devops-mcp server is the recommended choice for new integrations going forward.

What it does

An MCP server that bridges AI assistants such as Claude to Azure DevOps through its REST API, translating natural-language requests into DevOps operations. Implemented today: work item management, including WIQL queries to search work items, retrieving full work item details, creating new work items (tasks, bugs, user stories, and other types), updating existing work item fields and properties, posting and retrieving comments, and establishing parent-child hierarchy relationships between items. Also implemented: project management functions, including listing all accessible projects in the organization, listing teams, viewing team membership, retrieving team area paths, and accessing team iteration and sprint configurations. Planned but not yet implemented: pipeline status queries and triggering pipeline runs, pull request creation/update/review, sprint planning and management, and branch policy administration.

When to use - and when NOT to

Important caveat: this repository is explicitly marked by its maintainer as no longer maintained, with users directed instead to Microsoft's official Azure DevOps MCP server (microsoft/azure-devops-mcp) for better ongoing support and the latest features. Reach for this connector only if a specific integration need isn't yet covered by the official server, and go in understanding it will not receive further updates or bug fixes. For any new Azure DevOps MCP integration, prefer the officially maintained alternative first.

Where it remains functionally useful, when it's already in place: automating work item search, creation, updates, and commenting in Azure DevOps through natural language, or querying project, team, and iteration structure without leaving the AI assistant session.

Capabilities

Work items: WIQL-based search, detail retrieval, creation across work item types, field and property updates, comment posting and comment-history retrieval, and parent-child hierarchy linking. Projects and teams: list all accessible projects, list teams, view team membership, retrieve team area paths, and access team iteration/sprint configuration. Not yet available in this server: pipeline operations, pull request handling, sprint management actions, and branch policy administration - these are documented as planned, not shipped.

How to install

Requires Python 3.10+, an Azure DevOps account with appropriate permissions, and a Personal Access Token (PAT) with the necessary API scopes.

pip install mcp-azure-devops

Configuration is supplied through a .env file setting AZURE_DEVOPS_PAT and AZURE_DEVOPS_ORGANIZATION_URL (the full organization URL, for example https://dev.azure.com/your-organisation). Run it in development mode with the MCP Inspector via mcp dev src/mcp_azure_devops/server.py, or install it directly into Claude Desktop via mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant". The codebase is organized into feature modules - features/work_items, features/projects, features/teams, and a shared utils module for client initialization - for anyone extending it despite the maintenance notice.

Who it's for

Teams already using Azure DevOps for work item tracking who want an AI assistant to query, create, and update work items and inspect project or team structure conversationally - with the explicit caveat that Microsoft's officially maintained server is now the recommended path for any new setup.

Source README

MCP Azure DevOps Server

⚠️ NOTICE: Official Server Available

Please use the official Microsoft Azure DevOps MCP server instead:

https://github.com/microsoft/azure-devops-mcp

This repository is no longer maintained. The official Microsoft server provides better support, ongoing maintenance, and the latest features.

A Model Context Protocol (MCP) server enabling AI assistants to interact with Azure DevOps services.

Overview

This project implements a Model Context Protocol (MCP) server that allows AI assistants (like Claude) to interact with Azure DevOps, providing a bridge between natural language interactions and the Azure DevOps REST API.

Features

Currently implemented:

Work Item Management

  • Query Work Items: Search for work items using WIQL queries
  • Get Work Item Details: View complete work item information
  • Create Work Items: Add new tasks, bugs, user stories, and other work item types
  • Update Work Items: Modify existing work items' fields and properties
  • Add Comments: Post comments on work items
  • View Comments: Retrieve the comment history for a work item
  • Parent-Child Relationships: Establish hierarchy between work items

Project Management

  • Get Projects: View all accessible projects in the organization
  • Get Teams: List all teams within the organization
  • Team Members: View team membership information
  • Team Area Paths: Retrieve area paths assigned to teams
  • Team Iterations: Access team iteration/sprint configurations

Planned features:

  • Pipeline Operations: Query pipeline status and trigger new pipeline runs
  • Pull Request Handling: Create, update, and review Pull Requests
  • Sprint Management: Plan and manage sprints and iterations
  • Branch Policy Administration: Configure and manage branch policies

Getting Started

Prerequisites

  • Python 3.10+
  • Azure DevOps account with appropriate permissions
  • Personal Access Token (PAT) with necessary scopes for Azure DevOps API access

Installation

# Clone the repository
git clone https://github.com/Vortiago/mcp-azure-devops.git
cd mcp-azure-devops

# Install in development mode
uv pip install -e ".[dev]"

# Install from PyPi
pip install mcp-azure-devops

Configuration

Create a .env file in the project root with the following variables:

AZURE_DEVOPS_PAT=your_personal_access_token
AZURE_DEVOPS_ORGANIZATION_URL=https://your-organization.visualstudio.com or https://dev.azure.com/your-organisation

Note: Make sure to provide the full URL to your Azure DevOps organization.

Running the Server

# Development mode with the MCP Inspector
mcp dev src/mcp_azure_devops/server.py

# Install in Claude Desktop
mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"

Usage Examples

Query Work Items

Show me all active bugs assigned to me in the current sprint

Create a Work Item

Create a user story in the ProjectX with the title "Implement user authentication" and assign it to john.doe@example.com

Update a Work Item

Change the status of bug #1234 to "Resolved" and add a comment explaining the fix

Team Management

Show me all the team members in the "Core Development" team in the "ProjectX" project

View Project Structure

List all projects in my organization and show me the iterations for the Development team

Development

The project is structured into feature modules, each implementing specific Azure DevOps capabilities:

  • features/work_items: Work item management functionality
  • features/projects: Project management capabilities
  • features/teams: Team management features
  • utils: Common utilities and client initialization

For more information on development, see the CLAUDE.md file.

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.