Azure Devops

Azure DevOps MCP Server

A READ-ONLY MCP (Model Context Protocol) server that connects AI assistants to Azure DevOps Server (on-premises). Works with Claude Code CLI, VS Code AI extensions (Continue, Cline), Cursor, and any MCP-compatible client.

Features

• Projects: List and explore projects
• Git/Repos: Browse repositories, commits, branches, pull requests, diffs, and code search
• Builds: List builds, view logs, analyze errors
• Work Items: Query work items, find linked commits/PRs
• Releases: View releases and deployment status
• Pipelines: List YAML pipelines, view runs, get pipeline configuration
• Test Results: View test runs, results, and analyze failures

Prerequisites

• Node.js 18 or higher
• Azure DevOps Server 2020 or 2022 (on-premises)
• Personal Access Token (PAT) with read scopes

Installation

Option 1: npm (Recommended)

npx azure-devops-mcp@latest

Option 2: Clone and Build

git clone https://github.com/elad-nofy/azure-devops-mcp.git
cd azure-devops-mcp
npm install
npm run build

Configuration

Create a Personal Access Token (PAT)

1. Go to Azure DevOps Server
2. Click on your profile icon > Security > Personal access tokens
3. Create a new token with the following scopes:
   • Code: Read
   • Build: Read
   • Work Items: Read
   • Release: Read
   • Test Management: Read

Configure MCP Client

Claude Code CLI

Add to your global settings (~/.claude.json on macOS/Linux, %USERPROFILE%\.claude.json on Windows):

Windows:

{
  "mcpServers": {
    "azure-devops": {
      "command": "cmd",
      "args": ["/c", "npx", "azure-devops-mcp"],
      "env": {
        "AZURE_DEVOPS_URL": "http://your-tfs-server:8080/tfs",
        "AZURE_DEVOPS_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_COLLECTION": "YourCollection",
        "AZURE_DEVOPS_PROJECT": "YourDefaultProject"
      }
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": ["azure-devops-mcp"],
      "env": {
        "AZURE_DEVOPS_URL": "http://your-tfs-server:8080/tfs",
        "AZURE_DEVOPS_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_COLLECTION": "YourCollection",
        "AZURE_DEVOPS_PROJECT": "YourDefaultProject"
      }
    }
  }
}

VS Code (Continue/Cline)

Add similar configuration to the extension's MCP settings.

Environment Variables

Available Tools

Projects

Git / Repositories

Builds

Work Items

Releases

Pipelines

Test Results

Usage Examples

Once configured, you can ask your AI assistant questions like:

• "Show me the recent builds for project X"
• "What's the status of PR #123?"
• "List all bugs assigned to me"
• "Show me the commits from last week"
• "Why did build #456 fail?"
• "What tests failed in build #789?"
• "Compare branches Dev/9.1 and Dev/9.2"
• "Search for 'IMediator' in the Controllers folder"

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

Troubleshooting

Connection errors

• Verify AZURE_DEVOPS_URL is correct and accessible
• Check if your PAT has not expired
• Ensure your network allows connection to the server

Permission errors

• Verify PAT has required scopes
• Check if you have access to the project/repository

"Project is required" errors

• Set AZURE_DEVOPS_PROJECT environment variable, or
• Pass project parameter in tool calls

License

MIT