Azure DevOps MCP Server
A Model Context Protocol (MCP) server that enables Claude to interact with Azure DevOps work items, projects, wikis, and boards directly through natural language.
에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
A Model Context Protocol (MCP) server that enables Claude to interact with Azure DevOps work items, projects, wikis, and boards directly through natural language.
MCP server for Azure DevOps integration - enables Claude to manage work items, projects, and boards through natural language
Project Management
Sprint & Iteration Management 🆕
Work Item Operations
Personal Productivity
my-items, my-bugs, my-tasks, recent)Work Item Relationships
Wiki Management 🆕
Before installing this MCP server, ensure you have:
Node.js (v18.0.0 or higher)
node --version # Should output v18.0.0 or higher
Azure CLI installed and configured
# Install Azure CLI (if not already installed)
# macOS
brew install azure-cli
# Windows
winget install Microsoft.AzureCLI
# Linux/WSL
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
Azure DevOps Extension for Azure CLI
az extension add --name azure-devops
Azure Authentication
# Login to Azure
az login
# Optional: Set default organization (the tool will auto-configure if not set)
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG
npm install -g @jybrd/azure-devops-mcp
# Clone the repository
git clone https://github.com/jaybird-us/azure-devops-mcp.git
cd azure-devops-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Optional: Link globally
npm link
Add the following to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"azure-devops": {
"command": "npx",
"args": ["@jybrd/azure-devops-mcp"],
"env": {
"AZURE_DEVOPS_ORG": "https://dev.azure.com/YOUR_ORG"
}
}
}
}
For local development installation:
{
"mcpServers": {
"azure-devops": {
"command": "node",
"args": ["/absolute/path/to/azure-devops-mcp/dist/index.js"],
"env": {
"AZURE_DEVOPS_ORG": "https://dev.azure.com/YOUR_ORG"
}
}
}
}
You must configure your Azure DevOps organization in one of two ways:
Option 1: In Claude Desktop config (Recommended)
"env" section with your organization URL as shown aboveOption 2: Via Azure CLI
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG
Categories:
Note: Query management tools have been removed in v2.1.0 for improved reliability
list_projectsLists all projects in your Azure DevOps organization with details including name, description, state, and visibility.
query_work_itemsQuery work items using WIQL or built-in shortcuts:
"my-items" - All items assigned to you"my-bugs" - Bugs assigned to you"my-tasks" - Tasks assigned to you"recent" - Recently modified items (last 7 days)Parameters:
query (required): WIQL query or shortcut nameproject (optional): Limit results to specific projectget_work_itemRetrieve detailed information about a specific work item.
Parameters:
id (required): Work item IDfields (optional): Comma-separated list of specific fields to retrievecreate_work_itemCreate a new work item in Azure DevOps.
Parameters:
type (required): Work item type (Task, Bug, User Story, Feature, Epic, Issue)title (required): Work item titledescription (optional): Detailed descriptionassigned_to (optional): Assignee email or "@Me"tags (optional): Semicolon-separated tagsproject (optional): Target project nameupdate_work_itemUpdate an existing work item.
Parameters:
id (required): Work item IDtitle (optional): New titlestate (optional): New state (New, Active, Resolved, Closed, Removed)assigned_to (optional): New assigneedescription (optional): New descriptioncomment (optional): Add a comment with the updateadd_commentAdd a comment to an existing work item.
Parameters:
id (required): Work item IDcomment (required): Comment textlist_my_workList all work items assigned to you, organized by state.
Parameters:
include_recently_completed (optional): Include items completed in the last 7 dayslist_iterationsList all iterations/sprints in a project.
Parameters:
project (required): Project nameteam (optional): Team namedepth (optional): Depth of iteration treeget_current_iterationGet the current active sprint/iteration.
Parameters:
project (required): Project nameteam (optional): Team nameget_iteration_work_itemsGet all work items in a specific iteration.
Parameters:
project (required): Project nameiteration (required): Iteration name or pathmove_to_iterationMove a work item to a different iteration/sprint.
Parameters:
id (required): Work item IDiteration (required): Target iteration nameproject (optional): Project nameget_iteration_detailsGet detailed information about an iteration including work items grouped by type and state.
Parameters:
project (required): Project nameiteration (required): Iteration nameadd_work_item_relationAdd a relationship between work items.
Parameters:
id (required): Source work item IDrelation_type (required): Relationship type (e.g., "Parent", "Child", "Related", "Predecessor", "Successor", "Duplicate")target_id (optional): Target work item ID(s) - can be single ID or arraytarget_url (optional): URL to target work item (alternative to target_id)remove_work_item_relationRemove a relationship between work items.
Parameters:
id (required): Source work item IDrelation_type (required): Relationship type to removetarget_id (required): Target work item ID(s) to unlinkget_work_item_relationsShow all relationships for a work item with friendly categorization.
Parameters:
id (required): Work item IDlist_relation_typesList all available work item relation types in Azure DevOps.
Parameters: None
Once configured, you can ask Claude:
Work Item Management:
Sprint Management:
Relationship Management:
# Install dependencies
npm install
# Run in development mode (with TypeScript)
npm run dev
# Build for production
npm run build
# Run production build
node dist/index.js
azure-devops-mcp/
├── src/
│ └── index.ts # Main server implementation
├── dist/
│ └── index.js # Compiled JavaScript (generated)
├── package.json # Package configuration
├── tsconfig.json # TypeScript configuration
├── README.md # This file
└── LICENSE # MIT license
"Error: Cannot find module"
npm install to install dependenciesnpm run build"az: command not found"
"ERROR: Access Denied"
az login to authenticate"Organization not configured"
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG
To see detailed error messages, run the server directly:
node dist/index.js
This project is licensed under the MIT License - see the LICENSE file for details.
This is an unofficial tool that interfaces with Azure DevOps through the Azure CLI. It is not affiliated with or endorsed by Microsoft Corporation. Azure DevOps is a trademark of Microsoft Corporation.
Users must have their own Azure DevOps account and appropriate licenses to use Azure DevOps services. This tool simply provides an interface to interact with Azure DevOps through the Model Context Protocol.
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)For issues, questions, or suggestions, please open an issue on GitHub.
Made with ❤️ for the MCP community
MCP server for Azure DevOps integration - enables Claude to manage work items, projects, and boards through natural language
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Azure Devops은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-10-27. MCP server for Azure DevOps integration - enables Claude to manage work items, projects, and boards through natural language