> ## Documentation Index
> Fetch the complete documentation index at: https://agents.nanonets.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub List Issues

> Lists issues in a GitHub repository with labels and a body preview, pull requests omitted.

Lists issues in a repository, most recently updated first, with labels and a short body preview. Pull requests are omitted — GitHub's API mixes them into the same list, so this tool filters them out. Use `github_get_issue` for the full description and comments.

## Authentication and enablement

Requires a connected native GitHub integration (`mcp:github`) — a first-party GitHub App connection, not Composio. The connector is shown on Trail and to Nanonets superadmins; it is hidden from Nanonets customers during rollout.

Connecting opens GitHub's install page for the Trail GitHub App, where the user picks the account and either all repositories or only selected ones. Tools act as the app's bot account through short-lived installation tokens — not as the connecting user — and reach only the repositories of that installation. To change which repositories are included, edit the installation on GitHub (the account's or organization's installed GitHub Apps settings) or reconnect. If an organization owner still has to approve the app, calls fail until they do; if the app was uninstalled or suspended, calls fail until GitHub is reconnected.

Relies on the app's Issues (read) permission.

## Inputs

* `owner` (required): repository owner (user or organization).
* `repo` (required): repository name.
* `state` (optional): `open` (default), `closed`, or `all`.
* `labels` (optional): only issues carrying all of these labels. A label name containing a comma is refused, because GitHub's filter is comma-separated.
* `limit` (optional): max issues to return (1–100). Default 25.

## Output

* `issues`: number, title, state, URL, author, labels, assignees, comment count, last-updated time, and the first 300 characters of the body per issue.
* `total`: count of issues returned.

## Limits and side effects

* Read-only.
* `owner`/`repo` must be plain GitHub names (letters, numbers, `.`, `_`, `-`); anything else is rejected before any API call.
* Scans at most 300 items (three pages of 100, issues and pull requests combined) to fill `limit`, so in a repository dominated by recently-updated pull requests older issues may not surface.
* Body previews are cut by character, never mid-character.

## Expected errors

* No GitHub connection, a connection still waiting for an organization owner to approve the app, or an app that was uninstalled or suspended (reconnect GitHub).
* Invalid `owner`/`repo` format.
* Invalid `state` (must be `open`, `closed`, or `all`).
* GitHub API errors surface as the tool's error, rewritten to say what to fix: not found or no access to that repository (404 — check which repositories the installation includes), the repository is empty (no commits yet, HTTP 409), rate limit reached with the retry time (including GitHub's secondary limits, which ask for a one-minute wait), rejected app credentials (reconnect).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.