ado

Azure DevOps Plugin for Claude Code

Integrates Azure DevOps with Claude Code via the official Microsoft Azure DevOps MCP server.

Features

• Work Items: Query, create, update, and link work items
• Repositories: Browse repos, commits, and manage pull requests
• Pipelines: Monitor builds, view logs, trigger runs
• Wikis: Create and update documentation
• Projects: List and explore projects and teams

Requirements

• Node.js 20+
• Azure DevOps account with appropriate permissions
• Authentication via Azure CLI or Personal Access Token

Setup

1. Set your organization

# macOS/Linux
export ADO_ORGANIZATION="your_organization"

# Windows PowerShell
$env:ADO_ORGANIZATION = "your_organization"

For persistence, add to your shell profile or system environment variables.

2. Authenticate

Option A: Azure CLI (recommended)

az login
az devops configure --defaults organization=https://dev.azure.com/your_org

Option B: Personal Access Token

Create a PAT at https://dev.azure.com/_usersettings/tokens with scopes for:

• Work Items: Read & Write
• Code: Read & Write
• Build: Read & Execute
• Project and Team: Read

3. Verify connection

Start Claude Code and run /mcp to confirm azure-devops is connected.

Usage

Interact with Azure DevOps naturally:

• "List my Azure DevOps projects"
• "Show active bugs in the current sprint"
• "What's the status of the latest build?"
• "Create a work item for: Fix login timeout issue"

Commands

Command	Description
/setup	Guided Azure DevOps configuration

Agents

Agent	Description
ado-helper	Azure DevOps workflow assistant

Troubleshooting

MCP server won't connect:

1. Verify Node.js 20+: node --version
2. Test manually: npx -y @azure-devops/mcp YOUR_ORG
3. Check Azure CLI: az account show

Permission errors: Create a PAT with appropriate scopes at https://dev.azure.com/_usersettings/tokens

License

MIT