azure-devops

This MCP server enables Claude to interact with Azure DevOps resources such as work items, projects, wikis, and boards through natural language. You can query and manage work items, create and update items, and navigate project data using a rich set of tools like list_projects, query_work_items, get_work_item, create_work_item, update_work_item, add_comment, list_my_work, list_iterations, get_current_iteration, get_iteration_work_items, move_to_iteration, get_iteration_details, and a suite of relationship and wiki management tools. The server translates natural language prompts into structured API calls to Azure DevOps, returning detailed results that can be used directly in conversations or further actions. Start by ensuring your environment has Azure DevOps authentication configured, then use the MCP commands via Claude Desktop so Claude can issue the appropriate actions against your Azure DevOps organization.

Prerequisites:

• Node.js v18.0.0 or higher
• Access to npm (installed with Node.js)
• Azure DevOps organization and Azure CLI installed (optional for setup)

Option 1: Install from npm (Recommended)

1. Open a terminal
2. Install globally: ```bash npm install -g @jybrd/azure-devops-mcp

3. Run the MCP server as needed from Claude or your environment.

Option 2: Install from Source
1. Clone the repository:
```bash
# Clone the repository
git clone https://github.com/jaybird-us/azure-devops-mcp.git
cd azure-devops-mcp

2. Install dependencies:

npm install

3. Build the project (if required by the project setup):

npm run build

4. Optional: Link globally for easier CLI access:

npm link

Prerequisites in-depth (Azure):

• Ensure Node.js is v18+ and Azure CLI is installed and configured
• Install the Azure DevOps extension for Azure CLI: az extension add --name azure-devops
• Authenticate: az login and optionally set defaults with az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG

Environment variables: You must configure your Azure DevOps organization. The recommended approach is to set AZURE_DEVOPS_ORG in the MCP config (Claude Desktop) so Claude can authenticate against the correct Azure DevOps organization. If you prefer, you can configure via Azure CLI instead. The MCP supports both npx-based usage for quick runs and a local Node-based run for development; ensure the path to the built server (in case of node usage) is absolute. If you encounter authentication or permission issues, confirm that the Azure DevOps extension is installed and that your AZURE_DEVOPS_ORG defaults are correctly set. For local development, keep your env vars secure and avoid embedding secrets in shared configurations.