Search Issues
search_issuesRead-onlyIdempotent
Search GitLab issues using text search or structured filtering by assignee, author, labels, and state.
Instructions
Search for issues with text search and/or structured filtering (assignee, author, labels, state). For filtering by assignee/author/labels without text search, leave searchTerm empty.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order (e.g., UPDATED_DESC, CREATED_DESC, CREATED_ASC). Defaults to UPDATED_DESC for recency. | |
| after | No | Pagination cursor. To fetch the next page, pass the previous response pageInfo.endCursor here and repeat until pageInfo.hasNextPage is false. Paginating this way is the reliable path to complete results and accurate totals. | |
| first | No | Number of issues to retrieve | |
| state | No | Filter by issue state (opened, closed, all) | all |
| fetchAll | No | Fetch multiple pages in one call, up to "first" items total (max 100) — NOT exhaustive. For complete results or accurate counts, leave this false and paginate via after (pageInfo.endCursor). | |
| labelNames | No | Filter by label names (e.g., ["Priority::High", "bug"]) | |
| searchTerm | No | Text search term (optional - leave empty to filter by assignee/author/labels only) | |
| projectPath | No | Optional project path (e.g., "group/project"). Omit for global search. | |
| authorUsername | No | Filter by author username (e.g., "cdhanlon") | |
| userCredentials | No | Your GitLab credentials (optional — falls back to the configured env token if not provided) | |
| assigneeUsernames | No | Filter by assignee usernames (e.g., ["cdhanlon", "jsmith"]) |