az-devops-cli-mcp

Azure DevOps MCP tools for Claude Code and Codex CLI — boards, work items, repos, and PRs.

Install & Register

# 1. Install
pip install az-devops-cli-mcp

# 2. Login (once per machine)
az login
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG

# 3. Register with Claude Code
claude mcp add az-devops-cli-mcp -- python -m az_devops_cli_mcp.server

# 4. Register with Codex CLI
codex mcp add az-devops-cli-mcp -- python -m az_devops_cli_mcp.server

Restart Claude Code or Codex CLI. All 13 tools are ready.

How It Works

The server runs as a stdio process — spawned on demand by the client, no ports or background services needed.

Claude Code / Codex CLI
        |  spawns on demand
        v
python -m az_devops_cli_mcp.server   (stdin/stdout)
        |
        v
      az CLI  (your az login session)

Available Tools (13 total)

Work Items

Repos / PRs

AG2 Usage (optional)

from autogen import ConversableAgent
from az_devops_cli_mcp import ALL_TOOLS, WORK_ITEM_TOOLS, REPO_TOOLS

agent = ConversableAgent(
    name="devops_agent",
    tools=ALL_TOOLS,
    system_message="You manage Azure DevOps for LytStore..."
)

Configuration

Safety

Destructive commands (delete, remove, destroy) are blocked at the core layer. The agent returns an error and requires explicit user confirmation.

Manual MCP Config (fallback)

If claude mcp add / codex mcp add aren't available, add this to your config file manually.

Claude Code — ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "az-devops-cli-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "az_devops_cli_mcp.server"]
    }
  }
}

Codex CLI — ~/.codex/config.json: same block.

Contributing

git clone https://github.com/PraiseSinkamba/az-devops-cli-mcp
cd az-devops-cli-mcp
pip install -e ".[dev]"
pytest tests/