list_issues
Retrieve and filter issues from a GitHub repository by specifying parameters such as owner, repo, state, labels, sort, direction, and date. Supports pagination for efficient data retrieval.
Instructions
List issues from a GitHub repository.
Args:
params: Parameters for listing issues including:
- owner: Repository owner (user or organization)
- repo: Repository name
- state: Issue state (open, closed, all)
- labels: Filter by labels
- sort: Sort field (created, updated, comments)
- direction: Sort direction (asc, desc)
- since: Filter by date
- page: Page number for pagination
- per_page: Number of results per page (max 100)
Returns:
List of issues from GitHub API
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Input Schema (JSON Schema)
{
"$defs": {
"ListIssuesParams": {
"description": "Parameters for listing issues.",
"properties": {
"direction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort direction: asc, desc",
"title": "Direction"
},
"labels": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by labels (list of label names)",
"title": "Labels"
},
"owner": {
"description": "Repository owner (username or organization)",
"title": "Owner",
"type": "string"
},
"page": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Page number for pagination (1-based)",
"title": "Page"
},
"per_page": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Results per page (max 100)",
"title": "Per Page"
},
"repo": {
"description": "Repository name",
"title": "Repo",
"type": "string"
},
"since": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by date (ISO 8601 format with timezone: YYYY-MM-DDThh:mm:ssZ)",
"title": "Since"
},
"sort": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sort by: created, updated, comments",
"title": "Sort"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Issue state: open, closed, all",
"title": "State"
}
},
"required": [
"owner",
"repo"
],
"title": "ListIssuesParams",
"type": "object"
}
},
"properties": {
"params": {
"$ref": "#/$defs/ListIssuesParams"
}
},
"required": [
"params"
],
"title": "list_issuesArguments",
"type": "object"
}