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 your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select GitHub from the integration list
- 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 agent revision
Using in Your Agent
- In an Agent Step, attach GitHub tools from the tools panel
- The agent uses your integration config to authenticate all GitHub API calls
- 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 |