azure-devops-work-items-mcp 1.0.0

MCP server for Azure DevOps work items — read, list, create, and update, with WIQL-based filtering

azure-devops-work-items-mcp

An MCP server for Azure DevOps work items: get, list/filter, create, and update. Filtering supports state, work item type, assignee, and area path directly, plus an open-ended custom_filter parameter that accepts a raw WIQL WHERE-clause fragment for anything else (sprint, priority, tags, date ranges, OR-logic).

No organization, project, or credentials are built in — everything is supplied via environment variables at runtime.

Configuration

Three environment variables are required:

Variable	Description
AZURE_DEVOPS_ORG	Your Azure DevOps organization name (the part after dev.azure.com/ in your URL)
AZURE_DEVOPS_PROJECT	The project name within that organization
AZURE_DEVOPS_PAT	A Personal Access Token with Work Items: Read & Write scope, created at https://dev.azure.com/<your-org>/_usersSettings/tokens

Usage with Claude Desktop (or any MCP client using uvx)

Add this to your MCP client's config (for Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "azure-devops": {
      "command": "uvx",
      "args": ["azure-devops-work-items-mcp"],
      "env": {
        "AZURE_DEVOPS_ORG": "your-org-name",
        "AZURE_DEVOPS_PROJECT": "your-project-name",
        "AZURE_DEVOPS_PAT": "your-personal-access-token"
      }
    }
  }
}

Use the full absolute path to uvx (find it with which uvx on macOS/Linux or where.exe uvx on Windows) if your client can't find it on PATH — this is a known issue with some desktop apps not inheriting a full shell PATH.

To pin to a specific version instead of always pulling the latest: "args": ["azure-devops-work-items-mcp==1.0.0"].

Tools

• ado_get_work_item(work_item_id)
• ado_list_work_items(state?, work_item_type?, assigned_to?, area_path?, custom_filter?, top?)
• ado_create_work_item(work_item_type, title, description?, assigned_to?, area_path?, iteration_path?, tags?)
• ado_update_work_item(work_item_id, title?, state?, description?, assigned_to?, area_path?, iteration_path?, tags?)

License

MIT