MCP Directory

How to add Azure DevOps MCP Server to Claude Desktop

Bring Azure DevOps context — work items, repos, pipelines, wikis, test plans — to your AI agents. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 1.9k★ · stdio · oauth

Claude Desktop config for Azure DevOps MCP Server

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

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Azure DevOps MCP Server config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Azure DevOps MCP Server's tools appear under the 🔌 tools menu.

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)

What Azure DevOps MCP Server can do in Claude Desktop

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.

Security

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 + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Azure DevOps MCP Server config there under the "mcpServers" key and restart the client.

Is Azure DevOps MCP Server safe to use with Claude Desktop?

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).

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.

View repo Full Azure DevOps MCP Server page