Updated March 2026

Install Azure DevOps MCP

Pick your client, copy the command, done.

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "AZURE_DEVOPS_ORG=${AZURE_DEVOPS_ORG}" -e "AZURE_DEVOPS_PAT=${AZURE_DEVOPS_PAT}" mcp-azure -- npx @slorenzot/mcp-azure
Required:AZURE_DEVOPS_ORGAZURE_DEVOPS_PAT+ 1 optional

Environment Variables

Set these before running Azure DevOps MCP.

VariableDescriptionRequired
AZURE_DEVOPS_ORGURL of the Azure DevOps organizationYes
AZURE_DEVOPS_PATPersonal Access Token for authenticationYes
AZURE_DEVOPS_PROJECTName of the Azure DevOps projectNo

Available Tools (15)

Once configured, Azure DevOps MCP gives your AI agent access to:

ado_configureConfigures the connection with organization, project, and PAT
organizationprojectpat
ado_get_work_itemObtains a Work Item by its ID
id
ado_create_work_itemCreates a new Work Item
titletypedescriptionareaPathiterationPathfields
ado_update_work_itemUpdates an existing Work Item
idfields
ado_get_work_item_type_fieldsObtains available/required fields for a type
type
ado_query_sprintQueries Work Items for a specific sprint
sprintName
ado_query_areaQueries Work Items for a specific area
areaPath
ado_query_wiqlExecutes a custom WIQL query
wiqlgetDetails
ado_list_iterationsLists project iterations/sprints
ado_list_areasLists project areas
ado_add_commentAdds a comment to a Work Item
idcomment
ado_get_commentsObtains comments from a Work Item
id
ado_upload_attachmentUploads a file and returns the attachment URL
filePath
ado_add_attachmentAdds an attachment to a Work Item
workItemIdfilePathcomment
ado_get_attachmentsLists attachments of a Work Item
id

Try It Out

After setup, try these prompts with your AI agent:

Create a new User Story titled 'Implement OAuth' in the Backend area for Sprint 5.
Run a WIQL query to find all active bugs assigned to me.
Generate a daily standup report based on my current work items.
Add a comment to work item 12345 with the analysis results in Markdown format.
List all iterations available in the current project.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • AZURE_DEVOPS_ORG — URL of the Azure DevOps organization
  • AZURE_DEVOPS_PAT — Personal Access Token for authentication
Alternative installation methods

NPX

npx @slorenzot/mcp-azure

Keep this setup from going cold

Save the docs, env vars, and workflow around Azure DevOps MCP in Conare so Claude Code, Codex, and Cursor remember it next time.

Need the legacy visual installer? Open Conare IDE.
Remember this setup