azure-devops-mcp-server MCP Server

What is azure-devops-mcp-server?

azure-devops-mcp-server is a TypeScript-based MCP (Model Context Protocol) server that interacts with Azure DevOps Work Items via the Azure DevOps REST API (version 7.2) using axios. It is designed for users who want to manage work items through natural language in AI assistants.

How to use azure-devops-mcp-server?

Install dependencies with npm install, build with npm run build, set the environment variables AZURE_DEVOPS_ORG_URL (organization URL, e.g., https://dev.azure.com/YourOrganizationName) and AZURE_DEVOPS_PAT (Personal Access Token with read/write Work Item permissions), and add the server configuration to your Claude Desktop config file. Use the MCP Inspector (npm run inspector) for debugging.

Key features of azure-devops-mcp-server

• Create, read, update, and delete Work Items
• Batch fetch and batch update operations (up to 200 items)
• Search Work Items with multiple filter criteria
• Link Git commits or parent-child relationships to Work Items
• Manage attachments and add comments to Work Items
• List and get details of Azure DevOps projects

Use cases of azure-devops-mcp-server

• Quickly create and track User Stories, Bugs, or Tasks using natural language
• Efficiently update or delete multiple Work Items in a single batch request
• Search for Work Items by keyword, type, state, assignee, or custom fields
• Link code commits or establish parent-child relationships between Work Items
• Retrieve project details and list all projects in an organization

FAQ from azure-devops-mcp-server

How do I authenticate azure-devops-mcp-server with Azure DevOps?

Set the environment variables AZURE_DEVOPS_ORG_URL to your Azure DevOps organization URL and AZURE_DEVOPS_PAT to a Personal Access Token with read/write Work Item permissions.

What runtime does azure-devops-mcp-server require?

It requires Node.js and npm to install dependencies and build the server.

Which Azure DevOps API version does the server use?

It uses Azure DevOps REST API version 7.2 (stable).

What is the maximum number of Work Items I can process in a batch?

Batch fetch and batch update operations support up to 200 Work Items per request.

Can azure-devops-mcp-server permanently delete Work Items?

Yes, the delete_work_item tool supports both soft delete (moving to recycle bin) and permanent deletion via the optional destroy parameter.