MCP server for Azure DevOps work item management - create, query, update work items with AI assistants
npm install devops-wranglerAn 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.
``bash`
npx devops-wrangler
`bash`
npm install -g devops-wrangler
The easiest way to add the server:
`bash`
claude mcp add --transport stdio devops-wrangler -- npx devops-wrangler
Or manually add to your MCP settings (~/.claude/mcp_servers.json):
`json`
{
"mcpServers": {
"devops-wrangler": {
"command": "npx",
"args": ["devops-wrangler"]
}
}
}
Add to your Claude Desktop config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json
Windows:
`json`
{
"mcpServers": {
"devops-wrangler": {
"command": "npx",
"args": ["devops-wrangler"]
}
}
}
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
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)
| Tool | Description |
|------|-------------|
| ado_configure | Configure Azure DevOps connection with PAT and organization URL |ado_status
| | Check current configuration status |
| Tool | Description |
|------|-------------|
| ado_projects | List projects, set active project, or list area paths |
| 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 |
| Tool | Description |
|------|-------------|
| ado_comments | Add or list comments on work items (supports markdown) |ado_tags
| | List, add, remove, or query tags |
| Tool | Description |
|------|-------------|
| ado_sprints | List sprints, assign items to sprints, create/delete sprints |ado_plans
| | View delivery plans and roadmaps |
``
Create a Feature called "User Authentication" with these User Stories:
- Implement login page
- Add password reset flow
- Create session management
``
Show me all active bugs in the project
``
Create a Task called "Fix API timeout" and add it to the current sprint
```
Update work item #12345 - set state to "Active" and assign to john@example.com
- 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
ISC