search_workitem

Search and filter Azure DevOps work items by text, project, area path, type, state, or assigned users using PAT authentication. Supports pagination and optional facet inclusion for detailed results.

Instructions

Get Azure DevOps Work Item search results for a given search text

Input Schema

Name	Required	Description
`areaPath`	No	Filter by area paths
`assignedTo`	No	Filter by assigned to users
`includeFacets`	No	Include facets in the search results
`project`	No	Filter by projects
`searchText`	Yes	Search text to find in work items
`skip`	No	Number of results to skip for pagination
`state`	No	Filter by work item states
`top`	No	Number of results to return
`workItemType`	No	Filter by work item types

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "areaPath": {
      "description": "Filter by area paths",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "assignedTo": {
      "description": "Filter by assigned to users",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "includeFacets": {
      "default": false,
      "description": "Include facets in the search results",
      "type": "boolean"
    },
    "project": {
      "description": "Filter by projects",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "searchText": {
      "description": "Search text to find in work items",
      "type": "string"
    },
    "skip": {
      "default": 0,
      "description": "Number of results to skip for pagination",
      "type": "number"
    },
    "state": {
      "description": "Filter by work item states",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "top": {
      "default": 10,
      "description": "Number of results to return",
      "type": "number"
    },
    "workItemType": {
      "description": "Filter by work item types",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "searchText"
  ],
  "type": "object"
}

This server cannot be installed

Other Tools from Azure DevOps MCP Server with PAT Authentication

Related Tools

search_work_items
@Tiberriver256/mcp-server-azure-devops
list_work_items
@mmruesch12/azdo-mcp
searchWorkItems
@RyanCardin15/AzureDevOps-MCP
query_work_items
@Vortiago/mcp-azure-devops
getMyWorkItems
@RyanCardin15/AzureDevOps-MCP
core_list_projects
@ennuiii/DevOpsMcpPAT