Overview

Many organizations run Azure DevOps Server, formerly known as Team Foundation Server (TFS), on their own infrastructure. Integrating it with modern agentic AI tools and LLMs can be difficult. The official Microsoft Azure DevOps MCP server supports only the cloud-hosted Azure DevOps Services and is unlikely to support Azure DevOps Server in the future.

This MCP server closes that gap and enables smooth integration with Azure DevOps Server.

This project is under active development, with features continuously added to meet current requirements. Community needs are highly valued — if you miss any features, please submit an Issue. User-requested features are fast-tracked and will be prioritized and added as soon as possible.

Key Advantages

One of the most important features of this MCP server is NTLM authentication support. NTLM is required by many on-premises and enterprise environments where users authenticate with Windows domain credentials, either directly or over VPN. Most MCP servers for Azure DevOps target only cloud-hosted Azure DevOps Services with token-based auth and cannot connect to these environments.

• NTLM authentication (Windows domain credentials) for on-prem and VPN-based setups where no other auth method works.
• PAT and OAuth bearer token authentication as alternatives when available.
• Enables secure access to Azure DevOps Server from MCP-compatible AI tools such as GitHub Copilot, Claude Desktop, Cursor, Windsurf, and others.
• Works in restricted or offline environments without exposing sensitive data to external services.
• Retrieves commit diffs with clear added/removed lines, similar to the Azure DevOps web UI.
• Helps keep and track project documentation alongside code changes.
• Automates common tasks such as work item management and code review processes.

Getting Started

Prerequisites

Python 3.10+ and uv are required. If not yet installed, see installation guide.

Quick Install

Click one of the buttons below to install directly in your IDE. You will be prompted for credentials:

For other platforms, see Manual Installation in the Getting Started guide.

Manual Installation

The MCP server can be installed manually in the following AI tools: VS Code, Visual Studio, Cursor, Goose, LM Studio, Amp, Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, Qodo Gen, Warp, Windsurf, GitHub Copilot CLI, GitHub Copilot Coding Agent, and others.

For step-by-step instructions, see Manual Installation in the Getting Started guide.

Configuration

The DEVOPS_API_URL must point to your full project URL:

https://<your-devops-server>/<organization>/<project>

The server supports three authentication methods. If you are unsure which one to use, start with NTLM because it is the most common for on-prem/VPN setups.

For detailed setup instructions for each method, see Authentication in the Getting Started guide.

With NTLM (username + password)

{
  "mcpServers": {
    "devops-onprem": {
      "command": "uvx",
      "args": ["mcp-devops-onpremise@latest"],
      "env": {
        "DEVOPS_API_URL": "https://your-devops-server/your-organization/your-project",
        "DEVOPS_USERNAME": "DOMAIN\\your-username",
        "DEVOPS_PASSWORD": "your-password"
      }
    }
  }
}

With PAT

{
  "mcpServers": {
    "devops-onprem": {
      "command": "uvx",
      "args": ["mcp-devops-onpremise@latest"],
      "env": {
        "DEVOPS_API_URL": "https://your-devops-server/your-organization/your-project",
        "DEVOPS_PAT": "your-personal-access-token"
      }
    }
  }
}

If you used a permanent install, replace "command": "uvx" with "command": "mcp-devops-onpremise" and remove the "args" line.

Claude plugin

The claude-plugin/ folder packages this server as a Claude plugin (Claude Code, Claude Desktop/Cowork). It launches the pinned PyPI release with uvx and asks for the project URL and credentials when you enable it; passwords and tokens are stored in the system's secure credential store. See claude-plugin/README.md.

The plugin pins an exact version (uvx mcp-devops-onpremise==X.Y.Z) and is updated automatically through the Claude plugin directory with every release. Manual configurations like the examples above use @latest, which uvx resolves to the newest release on every start.

Updating

All configuration examples use mcp-devops-onpremise@latest, which instructs uvx to fetch the latest version automatically on every run.

For permanent installs and release notes, see Updating in the Getting Started guide.

Available Tools

Pull Requests

Repositories

Work Items

Search

Wiki

Privacy Policy

The server runs locally and talks only to the Azure DevOps Server URL you configure. It collects no telemetry and stores no data, apart from attachment files you explicitly ask it to save. Full policy: PRIVACY.md.

Development

# Install dev dependencies
uv sync --group dev

# Run linting
uv run ruff check src/
uv run black --check src/

# Run tests
uv run pytest tests/

To publish a new version, see Releasing.

Community project, not affiliated with or endorsed by Microsoft. Azure DevOps is a trademark of Microsoft.