Azure DevOps MCP Server

What is Azure DevOps MCP Server?

A community-built Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with Azure DevOps resources (cloud and on-premises) through a standardized set of tools. It supports Azure DevOps Server (on-prem) for older versions that may not work with Microsoft's official server, as well as Azure DevOps Services (cloud).

How to use Azure DevOps MCP Server?

Install via npx (npx -y @tiberriver256/mcp-server-azure-devops) or run from source. Configure authentication with a Personal Access Token (PAT), Azure Identity, or Azure CLI. Set the required environment variable AZURE_DEVOPS_ORG_URL (organization URL or Server collection URL) and, optionally, AZURE_DEVOPS_DEFAULT_PROJECT. Integrate with Claude Desktop or Cursor AI by adding a JSON configuration block in your MCP settings file.

Key features of Azure DevOps MCP Server

• Manage projects, work items, repositories, pull requests, branches, and pipelines.
• Create and update work items, branches, pull requests, and commits.
• Search code, wiki pages, and work items across projects.
• Access repository content via standardized resource URIs.
• Three authentication methods: PAT, Azure Identity, and Azure CLI.
• Supports both Azure DevOps Services (cloud) and Azure DevOps Server (on-prem).

Use cases of Azure DevOps MCP Server

• Automate DevOps workflows using natural language via an AI assistant.
• Retrieve and update work items, pull requests, or pipeline runs on demand.
• Browse repository files and commit changes without leaving the chat interface.
• Manage Azure DevOps resources in on-premises environments where the official server may not work.
• Integrate Azure DevOps operations into larger MCP-based AI toolchains.

FAQ from Azure DevOps MCP Server

Does this server support Azure DevOps Server (on-premises)?

Yes. On-premises connections require Personal Access Token (PAT) authentication and the organization URL set to the Server collection (e.g., https://server:8080/tfs/DefaultCollection).

How do I authenticate with Azure DevOps Services?

You can use a Personal Access Token (PAT), Azure Identity (DefaultAzureCredential), or Azure CLI login. Set AZURE_DEVOPS_AUTH_METHOD to pat, azure-identity, or azure-cli and provide the corresponding credentials.

What environment variables are required?

AZURE_DEVOPS_ORG_URL is required. All other variables are optional but needed for specific authentication methods or customization: AZURE_DEVOPS_AUTH_METHOD (default azure-identity), AZURE_DEVOPS_PAT, AZURE_DEVOPS_DEFAULT_PROJECT, AZURE_DEVOPS_API_VERSION, AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, and LOG_LEVEL.

Is this the official Microsoft MCP server for Azure DevOps?

No. This is a community server. Microsoft maintains an official, product-supported server at microsoft/azure-devops-mcp. This community server is a good alternative when you need on-premises support or features not yet available in the official server.

What runtime does it require?

Node.js v16 or later and npm or yarn. The server runs as a local process and communicates via MCP (stdio-based transport).