Azure Boards MCP
Connects Claude to Azure DevOps Boards via personal access token, letting you read and write work items without leaving your editor. Runs on Bun with stdio transport, so it works in Cursor, Claude Desktop, or any MCP host that supports local servers. You'll configure your Azure org, project name, and PAT either through environment variables or a dotenv file. The author ships it as azure-board-mcp on npm and provides both bunx one-liner setup and local clone options. Reach for this when you're triaging bugs or updating tasks and want to stay in the same context as your code instead of switching to the Azure web UI.
- tools
- 43
- auth
- Secret needed
- transport
- STDIO
- env vars
- 3
- last updated
- Mar 27, 2026
Tools
43 toolsPublic tool metadata for what this MCP can expose to an agent.
auth_statusDiagnose auth issues, check which project is active
Diagnose auth issues, check which project is active
No parameter schema in public metadata yet.
switch_projectChange the active project, or list available ones
Change the active project, or list available ones
No parameter schema in public metadata yet.
list_work_itemsMy tasks, sprint board, filter by state/type/keyword (paginated)
My tasks, sprint board, filter by state/type/keyword (paginated)
No parameter schema in public metadata yet.
get_work_itemFull detail on a specific ticket: every field (custom ones like Definition of Done too), all comments, PRs. Nothing truncated
Full detail on a specific ticket: every field (custom ones like Definition of Done too), all comments, PRs. Nothing truncated
No parameter schema in public metadata yet.
create_work_itemCreate a task, bug, user story, epic, feature
Create a task, bug, user story, epic, feature
No parameter schema in public metadata yet.
update_work_itemClose, reassign, move sprint, update estimates
Close, reassign, move sprint, update estimates
No parameter schema in public metadata yet.
add_commentPost a note or status update on a ticket
Post a note or status update on a ticket
No parameter schema in public metadata yet.
list_commentsRead, edit, or delete ticket comments by ID
Read, edit, or delete ticket comments by ID
No parameter schema in public metadata yet.
update_commentRead, edit, or delete ticket comments by ID
Read, edit, or delete ticket comments by ID
No parameter schema in public metadata yet.
delete_commentRead, edit, or delete ticket comments by ID
Read, edit, or delete ticket comments by ID
No parameter schema in public metadata yet.
list_child_work_itemsSubtasks of a ticket, optionally the whole subtree
Subtasks of a ticket, optionally the whole subtree
No parameter schema in public metadata yet.
delete_work_itemMove to Recycle Bin, or destroy permanently
Move to Recycle Bin, or destroy permanently
No parameter schema in public metadata yet.
link_work_itemsSet parent/child, related, or dependency links
Set parent/child, related, or dependency links
No parameter schema in public metadata yet.
query_wiqlAdvanced queries with custom WIQL (paginated)
Advanced queries with custom WIQL (paginated)
No parameter schema in public metadata yet.
get_work_item_historyAudit trail — which fields changed, when, by whom
Audit trail — which fields changed, when, by whom
No parameter schema in public metadata yet.
get_backlogOrdered, priority-ranked product backlog
Ordered, priority-ranked product backlog
No parameter schema in public metadata yet.
get_sprintCurrent sprint dates and team capacity
Current sprint dates and team capacity
No parameter schema in public metadata yet.
list_sprintsAll sprints with start/end dates
All sprints with start/end dates
No parameter schema in public metadata yet.
get_boardKanban columns, state mappings, WIP limits
Kanban columns, state mappings, WIP limits
No parameter schema in public metadata yet.
list_team_membersWho's on a team (names, emails, admin flag)
Who's on a team (names, emails, admin flag)
No parameter schema in public metadata yet.
list_pathsValid area / iteration path values for create/update
Valid area / iteration path values for create/update
No parameter schema in public metadata yet.
list_reposDiscover repo names and URLs
Discover repo names and URLs
No parameter schema in public metadata yet.
list_filesBrowse directory structure
Browse directory structure
No parameter schema in public metadata yet.
get_fileRead file contents (up to 500 lines)
Read file contents (up to 500 lines)
No parameter schema in public metadata yet.
list_commitsRecent commits on a branch (paginated)
Recent commits on a branch (paginated)
No parameter schema in public metadata yet.
list_pull_requestsOpen PRs, reviewer votes, merge status (paginated)
Open PRs, reviewer votes, merge status (paginated)
No parameter schema in public metadata yet.
list_branchesBranches with ahead/behind counts
Branches with ahead/behind counts
No parameter schema in public metadata yet.
create_prOpen a PR with reviewers (by email), linked work items, optional auto-complete
Open a PR with reviewers (by email), linked work items, optional auto-complete
No parameter schema in public metadata yet.
get_pull_requestFull PR: description, reviewers and votes, linked work items, changed files
Full PR: description, reviewers and votes, linked work items, changed files
No parameter schema in public metadata yet.
list_pr_commentsComment threads with file/line context and replies
Comment threads with file/line context and replies
No parameter schema in public metadata yet.
add_pr_commentGeneral comment, inline file comment, or reply to a thread
General comment, inline file comment, or reply to a thread
No parameter schema in public metadata yet.
update_pr_threadResolve or reopen a thread
Resolve or reopen a thread
No parameter schema in public metadata yet.
vote_prApprove, approve with suggestions, wait for author, reject, reset
Approve, approve with suggestions, wait for author, reject, reset
No parameter schema in public metadata yet.
manage_pr_reviewersAdd (optionally required) or remove reviewers
Add (optionally required) or remove reviewers
No parameter schema in public metadata yet.
update_prEdit title/description/draft, complete (merge), auto-complete, abandon, reactivate
Edit title/description/draft, complete (merge), auto-complete, abandon, reactivate
No parameter schema in public metadata yet.
list_pipelinesDiscover pipeline definitions
Discover pipeline definitions
No parameter schema in public metadata yet.
list_buildsRecent builds — status, result, branch, link
Recent builds — status, result, branch, link
No parameter schema in public metadata yet.
run_pipelineTrigger a pipeline run
Trigger a pipeline run
No parameter schema in public metadata yet.
get_build_timelineWhich stage/job/task failed, with error/warning counts
Which stage/job/task failed, with error/warning counts
No parameter schema in public metadata yet.
get_build_logsFull logs and error messages of failed steps, or any step by name or log ID
Full logs and error messages of failed steps, or any step by name or log ID
No parameter schema in public metadata yet.
cancel_buildCancel an in-progress build
Cancel an in-progress build
No parameter schema in public metadata yet.
list_releasesRecent releases with per-environment deploy status
Recent releases with per-environment deploy status
No parameter schema in public metadata yet.
create_releaseCreate and trigger a release from a definition
Create and trigger a release from a definition
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
AZURE_ORG*Azure DevOps organization name
AZURE_PROJECT*Azure DevOps project name
AZURE_PAT*secretPersonal access token (Work Items: Read & Write)
Readme
azure-board-mcp
MCP server for Azure DevOps. Work with tasks, sprints, bugs, pull requests, repositories, and pipelines directly from Claude, Cursor, or any MCP-compatible AI.
Quick start
# 1. Configure your editors (Claude Code, Cursor, VS Code, Claude Desktop)
npx azure-board-mcp install
# 2. Sign in once
npx azure-board-mcp authenticate
# 3. Restart your editor — done
On first use the AI will ask which Azure DevOps project to work on and remember it.
Install & authenticate
Browser sign-in (default)
npx azure-board-mcp authenticate
Opens your browser for Microsoft sign-in. Picks your org from a list. No Azure AD app setup required — uses a shared app registration built into the package.
PAT — Personal Access Token
For headless / CI environments or orgs that block third-party OAuth:
npx azure-board-mcp authenticate --pat
Create a PAT at https://dev.azure.com/{org}/_usersSettings/tokens with scopes: Work Items (Read & Write), Build (Read), Code (Read).
Editor setup
Option A — automatic (recommended)
Details
- Repository
- github.com/broisnischal/azure-mcp
- Website
- github.com/broisnischal/azure-mcp
- Category
- Cloud & Infrastructure
- Package
azure-board-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Cloud & Infrastructure MCP servers
View all
Self Healing Infrastructure Mcpcsoai-org/self-healing-infrastructure-mcpSelf Healing Infrastructure MCP Server by MEOK AI Labs0stars
Blueprint Agentic Staking (Solentic)blueprint-infrastructure/solentic-mcpNative Solana staking for AI agents. 26 MCP tools, one-shot signing, webhooks.0stars
Perceptdot Vercelio.github.perceptdot/vercelAI agent vision for Vercel deployments — with ROI measurement. perceptdot.com0stars
Azure FinOps MCP Serverraviteja-pegata/azure-finops-mcp-serverAzure FinOps MCP: cost, budgets, forecasting and optimization for Claude, VS Code and Cursor.0stars
Infrawisesidd27/infrawiseLive AWS, database & Kafka infrastructure context for AI coding assistants via MCP.22stars
clawopsdfridkin/clawopsDeploy self-hosted OpenClaw to AWS, GCP, Azure or a local VM — a CLI and an MCP server in one.6stars