Skip to main content
Lists the repositories the GitHub connection can reach — the ones chosen when the app was installed. Start here to find the owner/repo the other GitHub tools take.

​
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 Metadata (read) permission.

​
Inputs

  • limit (optional): max repositories to return (1–500). Default 25.

​
Output

  • repos: name, full name, private flag, URL, description, default branch, and last-updated time per repository.
  • total: count of repositories returned.
  • total_available: how many repositories the installation can reach. More than total means raise limit to see the rest.

​
Limits and side effects

  • Read-only.
  • Includes only the installation’s repositories, not every repository the connecting user can see.
  • Reads GitHub in pages of 100 until limit is met; values above 500 are capped at 500, and 0 or negative uses the default.

​
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).
  • 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), rate limit reached with the retry time (including GitHub’s secondary limits, which ask for a one-minute wait), rejected app credentials (reconnect).