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

# GitHub connector

> Let the agent read your repositories, issues and pull requests while it generates.

The GitHub connector lets the agent read your repositories, issues and pull requests. Use it to point the agent at code you already have, or to build dashboards and views from your GitHub data.

This is different from linking a project to a repository. The connector is for reading; [syncing a project with a repository](https://docs.polymet.ai/github/sync.md) is how a project's own code lives on GitHub. [Integrations, connectors and the MCP server](https://docs.polymet.ai/connectors/how-connections-differ.md) explains the difference.

![GitHub in the Agent connectors window, with the Connect button, the Agent access switch and the access Polymet asks for](https://mintcdn.com/polymet/TfIzLh80_L4bW9xQ/images/docs/connectors/github-card.png?fit=max\&auto=format\&n=TfIzLh80_L4bW9xQ\&q=85\&s=82e960caf0506914f0d4166a1d34256b)

## What the agent can do

* Read your repositories, including private ones you can access
* Read issues and pull requests

It cannot write. The connector uses GitHub's read-only access point, so the agent has no way to push code, open or close issues, or change anything on GitHub through it.

GitHub's approval screen asks for the `repo` permission, which GitHub describes as full access to repositories. GitHub has no narrower permission that reaches private repositories, so Polymet asks for that one and keeps the agent to the read-only access point.

## Connect

1. Click **Agent connectors** in the generation input.
2. Find **GitHub** and click **Connect**.
3. Sign in to GitHub in the popup and approve the access.

If your GitHub organization restricts third-party applications, an organization owner has to approve Polymet before its repositories show up.

## Try it

```text theme={null}
Read the open issues in acme/storefront labelled "bug" and build a triage
board grouped by priority.
```

```text theme={null}
Look at how the Button component is written in acme/design-system and build
the new pricing page with the same props and naming.
```

## Related

* [Agent connectors](https://docs.polymet.ai/connectors/agent-connectors.md) — approving calls, accept-all, turning a connector off, disconnecting
* [Sync a project with a repository](https://docs.polymet.ai/github/sync.md) — keep a project's code on GitHub


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