What are the required environment variables?

The server requires `AZURE_DEVOPS_ORG_URL`. Additional variables such as `AZURE_DEVOPS_AUTH_METHOD`, `AZURE_DEVOPS_PAT`, and service‑principal properties are needed depending on the chosen authentication method.

How do I use Azure DevOps MCP Server with Claude Desktop?

Add a configuration entry to your Claude Desktop config file with the command `npx -y @ramosjuan24/mcp-server-azure-devops` and the required environment variables (e.g., `AZURE_DEVOPS_ORG_URL`, `AZURE_DEVOPS_AUTH_METHOD`).

What credentials does it need?

It reads `AZURE_DEVOPS_ORG_URL`, `AZURE_DEVOPS_AUTH_METHOD`, `AZURE_DEVOPS_DEFAULT_PROJECT`, `AZURE_DEVOPS_PAT`, `AZURE_TENANT_ID`, `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Azure DevOps MCP Server

MCP N8N Azure Devops

Local serverstdio

What is the Azure DevOps MCP Server?

MCP N8N Azure Devops

The short version

A Model Context Protocol (MCP) server implementation for Azure DevOps, allowing AI assistants to interact with Azure DevOps APIs through a standardized protocol.

This server implements the Model Context Protocol (MCP) for Azure DevOps, enabling AI assistants like Claude to interact with Azure DevOps resources securely. The server acts as a bridge between AI models and Azure DevOps APIs, providing a standardized way to:

What it needs from you

Node.js (v16+) - npm or yarn - Azure DevOps account with appropriate access - Authentication credentials (see Authentication Guide for details): - Personal Access Token (PAT), or - Azure Identity credentials, or - Azure CLI login

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_me	Get details of the authenticated user (id, displayName, email)
list_organizations	List all accessible organizations
list_projects	List all projects in an organization
get_project	Get details of a specific project
get_project_details	Get comprehensive details of a project including process, work item types, and teams
list_repositories	List all repositories in a project
get_repository	Get details of a specific repository
get_repository_details	Get detailed information about a repository including statistics and refs
get_file_content	Get content of a file or directory from a repository
get_work_item	Retrieve a work item by ID
create_work_item	Create a new work item
update_work_item	Update an existing work item
list_work_items	List work items in a project
manage_work_item_link	Add, remove, or update links between work items

How to install the Azure DevOps MCP Server

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@ramosjuan24/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_AUTH_METHOD": "azure-identity",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Node.js (v16+) - npm or yarn - Azure DevOps account with appropriate access - Authentication credentials (see Authentication Guide for details): - Personal Access Token (PAT), or - Azure Identity credentials, or - Azure CLI login

Variable	Description	Required
AZURE_DEVOPS_ORG_URL	Endpoint or connection string the server talks to.	Yes
AZURE_DEVOPS_AUTH_METHOD	Configuration value read at startup.	Optional
AZURE_DEVOPS_DEFAULT_PROJECT	Configuration value read at startup.	Optional
AZURE_DEVOPS_PAT	Configuration value read at startup.	Optional
AZURE_TENANT_ID	Configuration value read at startup.	Optional
AZURE_CLIENT_ID	Configuration value read at startup.	Optional
AZURE_CLIENT_SECRET	Credential the server authenticates with.	Yes