Skip to main content
Glama

Azure DevOps MCP Server

An MCP (Model Context Protocol) server for managing Azure DevOps work items — Product Backlog Items (PBIs), Tasks, Bugs — and their comments, directly from an MCP-compatible client such as Kiro, Claude Desktop, or Cursor.

Configured for the organization DigiFY2025 and project DIGI STD FY26.

Features

  • Create, read, update PBIs

  • List your own unfinished work items

  • Flexible search/list with filters or raw WIQL

  • Add, list, update, delete comments on any work item

  • Automatic sprint detection based on the current date

  • Sensible defaults for area path and iteration path

Related MCP server: Azure MCP FastMCP Server

Prerequisites

Setup

  1. Install dependencies:

    npm install
  2. Create a .env file from the example and add your PAT:

    cp .env.example .env
    AZURE_DEVOPS_PAT=your-personal-access-token-here

    .env is git-ignored. Never commit your real PAT.

  3. Run the server:

    npm start

MCP Client Configuration

Add the server to your MCP client config (e.g. .kiro/settings/mcp.json):

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/absolute/path/to/azure-devops-mcp/index.js"],
      "env": {
        "AZURE_DEVOPS_PAT": "your-personal-access-token-here"
      }
    }
  }
}

Available Tools

Work items

Tool

Description

create-pbi

Create a Product Backlog Item. Auto-detects the current sprint and defaults the area path. Supports title, description, acceptance criteria, assignee, area/iteration path, start/target dates, and a parent link.

create-task

Create a Task, optionally linked under a parent PBI. Supports title, description, assignee, area/iteration path, remaining work, activity, and priority. Auto-detects the current sprint.

read-pbi

Read full details of any work item by ID (PBI or Task), including parent/child relations.

update-pbi

Update fields of any existing work item (title, description, state, priority, dates, tags, etc.). Works for both PBIs and Tasks.

delete-work-item

Delete any work item by ID. Moves to the Recycle Bin by default; set destroy: true to permanently delete (cannot be undone).

list-my-pbis

List work items assigned to you (via the PAT) that are not Done/Closed/Removed.

list-pbis

Search/list work items using filters (text, state, assignee, iteration, area) or a raw WIQL query.

Comments

Tool

Description

Parameters

add-comment

Add a comment to a work item.

id, text (HTML supported)

list-comments

List all comments on a work item.

id

update-comment

Edit an existing comment.

id, commentId, text

delete-comment

Delete a comment.

id, commentId

Configuration constants

Defined at the top of index.js:

  • ORG — Azure DevOps organization (DigiFY2025)

  • PROJECT — project name (DIGI STD FY26)

  • DEFAULT_AREA_PATH — default area path for new PBIs

  • SPRINT_LIST — sprint schedule used for automatic current-sprint detection

Security

  • Authentication uses the AZURE_DEVOPS_PAT environment variable only; no tokens are hardcoded.

  • .env is git-ignored so your PAT stays local.

  • Treat your PAT like a password: scope it minimally and rotate it if exposed.

License

MIT

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers