list_issues

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"
}

PyGithub MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from PyGithub MCP Server

Related Tools