Metadata-Version: 2.4
Name: azure-devops-work-items-mcp
Version: 1.0.1
Summary: MCP server for Azure DevOps work items — read, list, create, and update, with WIQL-based filtering
Project-URL: Repository, https://github.com/Camy-Ribeiro/azure-devops-work-items-mcp
Author: Camylla Ribeiro
License-Expression: MIT
License-File: LICENSE
Keywords: azure-devops,mcp,model-context-protocol,work-items
Requires-Python: >=3.10
Requires-Dist: mcp>=1.2.0
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# 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`):

```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
