devops-wrangler

An MCP (Model Context Protocol) server for Azure DevOps work item management. Enables AI assistants like Claude to create, query, update, and manage work items, sprints, and more.

Installation

Using npx (recommended)

npx devops-wrangler

Global installation

npm install -g devops-wrangler

Related MCP server: Azure DevOps MCP Server

Configuration

Claude Code

The easiest way to add the server:

claude mcp add --transport stdio devops-wrangler -- npx devops-wrangler

Or manually add to your MCP settings (~/.claude/mcp_servers.json):

{
  "mcpServers": {
    "devops-wrangler": {
      "command": "npx",
      "args": ["devops-wrangler"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "devops-wrangler": {
      "command": "npx",
      "args": ["devops-wrangler"]
    }
  }
}

Setup

Once configured, use the ado_configure tool to connect to your Azure DevOps organization:

Configure Azure DevOps with:
- PAT: your-personal-access-token
- Organization: https://dev.azure.com/your-org

Creating a Personal Access Token (PAT)

1. Go to Azure DevOps → User Settings → Personal Access Tokens

2. Create a new token with the following scopes:

   • Work Items: Read & Write

   • Project and Team: Read

   • Graph: Read (for user lookups)

Available Tools

Configuration

Projects

Work Items

Comments & Tags

Sprints & Plans

Usage Examples

Create a feature with user stories

Create a Feature called "User Authentication" with these User Stories:
- Implement login page
- Add password reset flow
- Create session management

Query active bugs

Show me all active bugs in the project

Add to current sprint

Create a Task called "Fix API timeout" and add it to the current sprint

Update work item

Update work item #12345 - set state to "Active" and assign to john@example.com

Features

• Hierarchical work item creation: Create Epics with Features, User Stories, and Tasks in a single operation

• Sprint management: List sprints, create new sprints, assign work items to current sprint

• Markdown support: Comments and descriptions support full markdown formatting

• Tag management: Add, remove, and query work items by tags

• Linking: Connect work items to each other, pull requests, commits, or branches

License

ISC