MCP Directory

Azure DevOps MCP Server

Bring Azure DevOps context — work items, repos, pipelines, wikis, test plans — to your AI agents.

Unverified
stdio (local)
OAuth
TypeScript
View repo 1.9k Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
npx -y @azure-devops/mcp <organization>

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "azure-devops-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@azure-devops/mcp",
        "${input:ado_org}"
      ]
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

  • Node.js 20+
  • An Azure DevOps organization and account with appropriate permissions
  • An MCP client (e.g. VS Code + GitHub Copilot, Visual Studio 2022, Claude Code, Cursor)

About Azure DevOps MCP Server

Official Microsoft MCP server that brings Azure DevOps data and actions to AI agents. It provides concise, single-purpose tools layered over the Azure DevOps REST APIs covering projects/teams, work items and backlogs, Git repositories and pull requests, pipelines and builds, wikis, test plans, code/wiki/work-item search, and Advanced Security alerts. The repo distributes a local stdio server (npm: @azure-devops/mcp) and Microsoft also offers a recommended remote streamable-HTTP endpoint.

Tools & capabilities (39)

mcp_ado_core_list_projects

List all projects in the organization.

mcp_ado_core_list_project_teams

List teams within a project.

mcp_ado_core_get_identity_ids

Retrieve Azure DevOps identity IDs by search filter.

mcp_ado_wit_get_work_item

Get a work item by ID.

mcp_ado_wit_get_work_items_batch_by_ids

Retrieve multiple work items by IDs.

mcp_ado_wit_create_work_item

Create a new work item.

mcp_ado_wit_update_work_item

Update fields of a work item.

mcp_ado_wit_add_child_work_items

Create child work items under a parent.

mcp_ado_wit_my_work_items

List work items relevant to the current user.

mcp_ado_wit_query_by_wiql

Execute a WIQL query and return matching work items.

mcp_ado_wit_link_work_item_to_pull_request

Link a work item to a pull request.

mcp_ado_work_list_iterations

List all iterations in a project.

mcp_ado_work_get_team_capacity

Get capacity for a specific team in an iteration.

mcp_ado_work_get_team_settings

Get team settings including default iteration and area.

mcp_ado_repo_list_repos_by_project

List all repositories in a project.

mcp_ado_repo_list_branches_by_repo

List all branches in a repository.

mcp_ado_repo_create_branch

Create a new branch from a source branch.

mcp_ado_repo_search_commits

Search for commits with comprehensive filters.

mcp_ado_repo_create_pull_request

Create a new pull request.

mcp_ado_repo_update_pull_request_reviewers

Add or remove reviewers from a pull request.

mcp_ado_repo_get_pull_request_changes

Get file changes (diff) for a pull request.

mcp_ado_repo_create_pull_request_thread

Create a new comment thread on a pull request.

mcp_ado_repo_get_file_content

Get file content at a specific version.

mcp_ado_pipelines_get_builds

Retrieve a list of builds with optional filters.

mcp_ado_pipelines_run_pipeline

Start a new pipeline run with optional parameters.

mcp_ado_pipelines_get_build_log

Retrieve complete logs for a build.

mcp_ado_pipelines_create_pipeline

Create a new pipeline with YAML configuration.

mcp_ado_pipelines_download_artifact

Download a pipeline artifact (relative destination paths only).

mcp_ado_search_code

Search for code across repositories.

mcp_ado_search_wiki

Search wiki pages by keywords.

mcp_ado_search_workitem

Search work items by text and filters.

mcp_ado_wiki_list_wikis

List wikis in the organization or project.

mcp_ado_wiki_get_page_content

Retrieve wiki page content.

mcp_ado_wiki_create_or_update_page

Create or update a wiki page.

mcp_ado_testplan_list_test_plans

List test plans in a project.

mcp_ado_testplan_create_test_case

Create a new test case work item.

mcp_ado_testplan_show_test_results_from_build_id

Get test results for a specific build.

mcp_ado_advsec_get_alerts

Retrieve Advanced Security alerts for a repository.

mcp_ado_advsec_get_alert_details

Get detailed information about a specific Advanced Security alert.

What this server can do

Azure DevOps MCP Server provides tools for these capabilities — tap one to see every MCP server that does the same:

Manage Git repos

When to use it

  • Let an AI agent triage and update Azure DevOps work items, backlogs, and iterations from natural language
  • Create branches and pull requests, request reviewers, and read PR diffs/comment threads during code review
  • Inspect pipeline/build status, fetch build logs, and trigger or retry pipeline runs
  • Search code, wikis, and work items across an organization, and create/update wiki documentation
  • Manage test plans, suites, and test cases, and surface test results and Advanced Security alerts

Security notes

Authentication uses your Microsoft account via interactive browser sign-in (or Azure CLI with --authentication azcli); ensure the credentials match the targeted Azure DevOps organization. The server inherits the permissions of the signed-in identity, so it can read and modify work items, repos, pipelines, and wikis. Use Domains (-d) to restrict the loaded toolset. The download-artifact tool only accepts relative destination paths (absolute paths and path traversal are blocked).

Azure DevOps MCP Server FAQ

Is this an official Microsoft project?

Yes. It is published by Microsoft (microsoft/azure-devops-mcp) and wraps Microsoft's own Azure DevOps service.

How do I authenticate?

The first time a tool runs, a browser opens to sign in with your Microsoft account; use credentials that match the targeted Azure DevOps organization. You can also pass --authentication azcli to use Azure CLI credentials.

How do I limit which tools are loaded?

By default all domains load. Add '-d' followed by domain names (core, work, work-items, search, test-plans, repositories, wiki, pipelines, advanced-security) to the server args to load only what you need. Always keep 'core' enabled for project-level info.

What's the difference between the local and remote server?

This repo ships the local stdio server (npx @azure-devops/mcp <org>). Microsoft also offers a recommended remote, streamable-HTTP endpoint (https://mcp.dev.azure.com/{organization}) that is the forward-looking option; the local server remains supported.

Which clients are supported?

VS Code + GitHub Copilot is the recommended experience, with getting-started docs for Visual Studio 2022, Claude Code, Cursor, Codex, Opencode, and Kilocode.

#azure-devops#microsoft#devops#pipelines#work-items#repositories#ci-cd#official

Alternatives to Azure DevOps MCP Server

Compare all alternatives →
GitHub MCP Server
DevOps & Cloud
31k

GitHub's official server for repos, issues, PRs, and Actions — local Docker or hosted remote.

Featured
Verified
stdio (local)
API key
Go
7 tools
Updated 15 days agoRepo
AWS API MCP Server
DevOps & Cloud
9.3k

Official AWS Labs server that lets agents call any AWS API via the AWS CLI surface.

Verified
stdio (local)
API key
Python
3 tools
Updated 17 days agoRepo
kubefwd
DevOps & Cloud
4.1k

Bulk Kubernetes port forwarding with an MCP server that lets AI assistants forward services, inspect pods, and monitor traffic.

Unverified
stdio (local)
No auth
Go
28 tools
Updated 9 days agoRepo

Compare Azure DevOps MCP Server with:

vs GitHub MCP Servervs AWS API MCP Servervs kubefwdvs Radar