Log inSubmit server
Azure Boards MCP logo

Azure Boards MCP

Manage Azure DevOps work items, repositories, pull requests, pipelines, builds, and releases through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Azure Boards MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "azure-boards-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "azure-board-mcp"
      ],
      "env": {
        "AZURE_ORG": "YOUR_VALUE_HERE",
        "AZURE_PROJECT": "YOUR_VALUE_HERE",
        "AZURE_PAT": "YOUR_VALUE_HERE",
        "AUTH_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 43 tools correctly (Today).

Overview

Azure Boards MCP MCP server exposes Azure DevOps Boards, repositories, pull requests, pipelines, builds, and releases through stdio-based MCP tools. It supports browser OAuth or PAT authentication, project switching, paginated queries, work-item mutations, code browsing, pipeline runs, and release creation. Use it when an MCP-compatible client needs to inspect or update Azure DevOps project activity without leaving the client.

Use cases

  • Review assigned work items and sprint progress
  • Create and update Azure DevOps tickets
  • Inspect pull requests and repository files
  • Diagnose failed builds from timelines and logs
  • Trigger pipelines and create releases

Key features

  • Azure DevOps work-item management
  • Sprint, board, backlog, and team queries
  • Repository and pull-request access
  • Pipeline and build diagnostics
  • Release listing and creation
  • OAuth and PAT authentication

Tools43

What Azure Boards MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

8/8 checks healthy over the last 51d

What it can do

From the 43 tools this server returned when we ran it.

Can delete or modify data · 4Handles credentials · 1Makes network requests · 2Read-only tools · 39
Network at startup4 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age220 days
Maintainers1

Observed 2026-11-02 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · azure-board-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads932Package downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed43Callable tools this server registers over MCP.

How Azure Boards MCP works

What Azure Boards MCP does

Azure Boards MCP MCP server connects an MCP-compatible AI client to Azure DevOps. Its work-item tools cover common planning and tracking tasks: listing filtered or assigned items, reading complete ticket details, creating tasks, bugs, user stories, epics, and features, updating fields, adding comments, linking items, and reviewing field-change history. Custom WIQL queries support more specific searches, while backlog, sprint, board, team, and path tools expose planning metadata.

The server also reaches into Azure DevOps repositories and delivery systems. It can discover repositories, browse file trees, read files up to 500 lines, inspect commits and pull requests, create pull requests, list pipeline definitions and builds, trigger or cancel builds, inspect build timelines and logs, and list or create releases. Created pull requests can include reviewers and linked work items.

How it works

Azure Boards MCP MCP server runs over stdio and is configured as a command in the MCP client. The README provides an automatic installer for Claude Code, Cursor, VS Code, and Claude Desktop, as well as manual configuration examples using npx azure-board-mcp@latest.

Authentication can use a browser-based Microsoft sign-in or a personal access token. After authentication, the client can select an Azure DevOps project; the selected project is remembered, and switch_project can change it or list available projects. auth_status helps diagnose credentials and identify the active project.

List operations for work items, commits, and pull requests are paginated. They return compact pages, with skip available for retrieving later results. This keeps list responses smaller than requesting an unrestricted result set.

Setup and configuration

Run npx azure-board-mcp install to configure detected editors, then run npx azure-board-mcp authenticate for browser sign-in. For headless environments or organizations that block the shared OAuth application, use npx azure-board-mcp authenticate --pat. The documented PAT scopes are Work Items read and write, Build read, and Code read.

The command-line interface also supports check for credential validation, logout for clearing stored credentials, and skills for installing a Claude Code skill that helps Claude decide when to use the tools. OAuth can request read-only scopes and can accept a custom client ID or tenant ID.

For CI or Docker, stored credentials can be overridden with AZURE_ORG, AZURE_PROJECT, AZURE_PAT, or the OAuth bearer-token variable AUTH_TOKEN. The listing identifies Bun as a requirement, while the README's setup commands use npx.

Tools and capabilities

  • Diagnose authentication and select the active Azure DevOps project.
  • Query, create, update, comment on, link, and audit work items.
  • Inspect backlogs, sprints, boards, team members, and valid area or iteration paths.
  • Browse repositories, files, commits, and pull requests.
  • Create pull requests with optional reviewers and linked work items.
  • Inspect, run, cancel, and troubleshoot builds and create releases.

Limitations and notes

The Azure Boards MCP MCP server is focused on Azure DevOps and does not provide a general project-management backend. File reads are limited to 500 lines, and several list tools return paginated results rather than complete collections in one response. PAT authentication requires the documented scopes, while organizations that restrict the built-in OAuth app may need a separately registered Azure AD application. The project must be selected before project-scoped operations are useful.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Azure Boards MCP

Azure Boards MCP is an MCP server that connects AI clients to Azure DevOps, including Boards, repositories, pull requests, pipelines, builds, and releases. Its main tools query and mutate work items, inspect code and PRs, run or diagnose builds, manage projects and sprints, and create releases through stdio.

Run `npx azure-board-mcp install` to configure detected Claude Code, Cursor, VS Code, or Claude Desktop installations. Then run `npx azure-board-mcp authenticate` and restart the client. Manual stdio configuration is also available in each client’s configuration file.

Run `npx azure-board-mcp authenticate --pat` to use a personal access token. The documented token scopes are Work Items read and write, Build read, and Code read. This mode is intended for headless or CI environments and for organizations that block third-party OAuth.

Yes, Azure Boards MCP works with Cursor through stdio configuration. Run `npx azure-board-mcp install` for automatic setup, or add the server command and `azure-board-mcp@latest` argument to Cursor’s `~/.cursor/mcp.json` file.

Use the `auth_status` tool or run `npx azure-board-mcp check` to inspect authentication state and the active project. You can also authenticate again, use PAT mode, or configure a custom Azure AD client and tenant when an organization blocks the built-in application.

Related MCP servers

All in Cloud Platforms All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAzure Boards MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/azure-boards-mcp?style=directory)](https://allmcps.com/mcp/azure-boards-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/azure-boards-mcp"><img src="https://allmcps.com/api/badge/azure-boards-mcp?style=directory" alt="Azure Boards MCP on AllMCPs" /></a>