Azure DevOps MCP Server
This server provides a convenient API for interacting with Azure DevOps services, enabling AI assistants and other tools to manage work items, code repositories, boards, sprints, and more. Built with the Model Context Protocol, it provides a standard
What is Azure DevOps MCP Server?
Azure DevOps MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this server provides a convenient api for interacting with azure devops services, enabling ai assistants and other tools to manage work items, code repositories, boards, sprints, and more. built with ...
This server provides a convenient API for interacting with Azure DevOps services, enabling AI assistants and other tools to manage work items, code repositories, boards, sprints, and more. Built with the Model Context Protocol, it provides a standard
This server falls under the Version Control category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- This server provides a convenient API for interacting with A
Use Cases
Maintainer
Works with
Installation
NPM
npx -y azure-devopsManual Installation
npx -y azure-devopsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Azure DevOps MCP Server
The Azure DevOps MCP Server is a TypeScript-based MCP server that connects AI assistants to Azure DevOps Work Items through the Azure DevOps REST API 7.2, enabling natural-language creation, retrieval, updating, deletion, and batch processing of work items without manually navigating the Azure DevOps portal. It exposes tools for work item CRUD operations, advanced search and filtering, parent-child linking, commit-to-work-item association, comments, attachments, and project listing. Development teams use it to let AI assistants like Claude manage sprint planning, triage backlogs, and track feature development directly from the chat interface.
Prerequisites
- Node.js 18+ with npm installed
- An Azure DevOps organization with at least one project
- An Azure DevOps Personal Access Token (PAT) with Work Items (Read & Write) permission
- The Azure DevOps organization URL in the format https://dev.azure.com/YourOrganization
- An MCP-compatible client such as Claude Desktop or Claude Code
Clone and build the server
Clone the azure-devops-mcp-server repository and build the TypeScript source.
git clone https://github.com/wuhuangjia/azure-devops-mcp-server.git
cd azure-devops-mcp-server
npm install
npm run buildCreate an Azure DevOps Personal Access Token
In Azure DevOps, go to User Settings → Personal Access Tokens → New Token. Set the scope to Work Items (Read & Write) and copy the generated token. Keep it secure as it will be used as an environment variable.
Configure the MCP client with environment variables
Add the server to your MCP client configuration, providing your organization URL and PAT as environment variables. The config file location depends on your client: on macOS it is at ~/Library/Application Support/Claude/claude_desktop_config.json.
Verify the connection
Restart your MCP client and ask it to list your Azure DevOps projects. If the server is configured correctly, it will call the list_projects tool and return your organization's project names.
Use work item tools in your AI session
With the server connected, your AI assistant can create, query, update, and link work items using natural language. The server maps requests to the appropriate Azure DevOps REST API calls automatically.
Azure DevOps MCP Server Examples
Client configuration (Claude Desktop)
Add the Azure DevOps MCP server to Claude Desktop's config, setting your organization URL and PAT as environment variables.
{
"mcpServers": {
"azure-devops": {
"command": "node",
"args": ["/path/to/azure-devops-mcp-server/build/index.js"],
"env": {
"AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/YourOrganization",
"AZURE_DEVOPS_PAT": "your_personal_access_token_here"
}
}
}
}Prompts to try
With the Azure DevOps MCP server connected, use natural language to manage your Azure DevOps work items.
- "List all open bugs in the MyProject project assigned to me"
- "Create a new User Story titled 'Add dark mode support' in the MyProject backlog with priority High"
- "Update work item #1234 to set its state to 'In Progress' and add a comment explaining why"
- "Get details for work items #100, #101, and #102 in a single request"
- "Link work item #500 as a parent of work items #501 and #502"
- "Search for all work items tagged 'sprint-42' and show their current states"Troubleshooting Azure DevOps MCP Server
Authentication fails with '401 Unauthorized' when calling any tool
Verify that AZURE_DEVOPS_PAT is set correctly and the token has not expired. Confirm the token was created with Work Items (Read & Write) scope. Regenerate the PAT in Azure DevOps if needed and update the environment variable in your MCP client config.
AZURE_DEVOPS_ORG_URL is rejected or returns 404
Ensure the URL is in the exact format https://dev.azure.com/YourOrganization with no trailing slash. Replace YourOrganization with your actual Azure DevOps organization name, which appears in the URL when you log in to dev.azure.com.
The server command fails to start with a 'Cannot find module' error
Run 'npm run build' from the azure-devops-mcp-server directory to compile the TypeScript before starting. Check that the path in the 'args' config entry points to the build/index.js file in the correct directory.
Frequently Asked Questions about Azure DevOps MCP Server
What is Azure DevOps MCP Server?
Azure DevOps MCP Server is a Model Context Protocol (MCP) server that this server provides a convenient api for interacting with azure devops services, enabling ai assistants and other tools to manage work items, code repositories, boards, sprints, and more. built with the model context protocol, it provides a standard It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Azure DevOps MCP Server?
Install via npm with the command: npx -y azure-devops. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Azure DevOps MCP Server?
Azure DevOps MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Azure DevOps MCP Server free to use?
Yes, Azure DevOps MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Azure DevOps MCP Server Alternatives — Similar Version Control Servers
Looking for alternatives to Azure DevOps MCP Server? Here are other popular version control servers you can use with Claude, Cursor, and VS Code.
Ruiyu MA
★ 30.1kConnect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
GitMCP
★ 8.1kTransforms any GitHub repository or GitHub Pages site into a documentation hub for AI assistants using the Model Context Protocol. It allows AI tools to access real-time code and documentation to prevent hallucinations and provide accurate API usage
GitHub Codemunch
★ 1.8kA token-efficient MCP server for exploring GitHub repositories using tree-sitter AST parsing to extract symbol signatures and summaries. It enables users to search and retrieve specific code components while significantly reducing token consumption c
GitHub Official
★ 1.2kOfficial GitHub integration with comprehensive API coverage
Azure DevOps
★ 367Enables interaction with Azure DevOps through Cursor chat, providing tools to manage builds, pipelines, work items, sprints, and board operations. Supports secure authentication via Personal Access Tokens and allows natural language-driven DevOps tas
MCP Git Ingest
★ 306Helps AI read GitHub repository structure and important files. Want to quickly understand what a repo is about? Prompt it with 'read https://github.com/adhikasp/mcp-git-ingest and determine how the code technically works'.
Browse More Version Control MCP Servers
Explore all version control servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Azure DevOps MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Azure DevOps MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.