GitHub
Access repositories, commits, issues, and collaborators on GitHub
The GitHub integration lets your agents interact with GitHub repositories — list issues, read commits, and view collaborators.
Prerequisites
You need one of the following from GitHub:
- Personal Access Token (PAT) — Generate one at GitHub Settings → Developer settings → Personal access tokens. Select the
reposcope for full repository access. - OAuth — For user-level access where each chat user authorizes with their own GitHub account.
Setup
- Open Integrations from the sidebar
- Select GitHub from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "GitHub - My Org")
- Choose your authentication method:
- Personal Access Token — Paste your PAT. You can map different tokens to different owner/repo combinations using auth mapping.
- OAuth — Click Connect to start the GitHub OAuth flow. You'll be redirected to GitHub to authorize access.
- Save the config
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach GitHub tools from the tools panel
- Tools are referenced as
github.list_issues,github.get_commit, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
list_issues | Get a list of issues from a GitHub repository | ReadOnly |
list_commits | Get list of commits from a GitHub repository | ReadOnly |
get_commit | Get a specific commit from a GitHub repository | ReadOnly |
list_collaborators | Get a list of collaborators for a GitHub repository | ReadOnly |
list_single_commit_comments | Get a list of comments for a specific commit | ReadOnly |