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

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

Tool	Description
ado_configure	Configure Azure DevOps connection with PAT and organization URL
ado_status	Check current configuration status

Projects

Tool	Description
ado_projects	List projects, set active project, or list area paths

Work Items

Tool	Description
ado_create_items	Create work items with optional hierarchy (Epic > Feature > User Story > Task)
ado_query_items	Query existing work items with filters
ado_update_item	Update work item fields (title, state, assignee, description, etc.)
ado_delete_item	Delete a work item (soft delete to recycle bin or permanent)
ado_link_item	Link work items to each other, PRs, commits, or branches

Comments & Tags

Tool	Description
ado_comments	Add or list comments on work items (supports markdown)
ado_tags	List, add, remove, or query tags

Sprints & Plans

Tool	Description
ado_sprints	List sprints, assign items to sprints, create/delete sprints
ado_plans	View delivery plans and roadmaps

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