Lets agents access Azure DevOps through the Python SDK to query and manage work items and related project data.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add azure-devops-server-vortiago --env AZURE_DEVOPS_ORGANIZATION_URL='<AZURE_DEVOPS_ORGANIZATION_URL>' --env AZURE_DEVOPS_PAT='<AZURE_DEVOPS_PAT>' -- uv pip install -e '.[dev]'~/.codex/config.toml
[mcp_servers.azure-devops-server-vortiago]
command = "uv"
args = ["pip", "install", "-e", ".[dev]"]
env = { AZURE_DEVOPS_ORGANIZATION_URL = "<AZURE_DEVOPS_ORGANIZATION_URL>", AZURE_DEVOPS_PAT = "<AZURE_DEVOPS_PAT>" }
# codex mcp add azure-devops-server-vortiago --env AZURE_DEVOPS_ORGANIZATION_URL='<AZURE_DEVOPS_ORGANIZATION_URL>' --env AZURE_DEVOPS_PAT='<AZURE_DEVOPS_PAT>' -- uv pip install -e '.[dev]'~/.cursor/mcp.json
{
"mcpServers": {
"azure-devops-server-vortiago": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
".[dev]"
],
"env": {
"AZURE_DEVOPS_ORGANIZATION_URL": "<AZURE_DEVOPS_ORGANIZATION_URL>",
"AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"azure-devops-server-vortiago": {
"type": "stdio",
"command": "uv",
"args": [
"pip",
"install",
"-e",
".[dev]"
],
"env": {
"AZURE_DEVOPS_ORGANIZATION_URL": "<AZURE_DEVOPS_ORGANIZATION_URL>",
"AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"azure-devops-server-vortiago": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
".[dev]"
],
"env": {
"AZURE_DEVOPS_ORGANIZATION_URL": "<AZURE_DEVOPS_ORGANIZATION_URL>",
"AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"azure-devops-server-vortiago": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
".[dev]"
],
"env": {
"AZURE_DEVOPS_ORGANIZATION_URL": "<AZURE_DEVOPS_ORGANIZATION_URL>",
"AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"azure-devops-server-vortiago": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
".[dev]"
],
"env": {
"AZURE_DEVOPS_ORGANIZATION_URL": "<AZURE_DEVOPS_ORGANIZATION_URL>",
"AZURE_DEVOPS_PAT": "<AZURE_DEVOPS_PAT>"
}
}
}
}Environment variables
AZURE_DEVOPS_ORGANIZATION_URLAZURE_DEVOPS_PAT
Replace the placeholders with your own credentials and keep them out of version control.