--- title: "GitHub Integration" description: "Connect AI agents to GitHub via OAuth2. Agents manage repos, issues, pull requests, files, releases, organizations, teams, secrets, variables, and trigger and monitor Actions workflows." url: https://flowrunner.ai/integrations/github date_modified: 2026-08-01T02:40:32-07:00 --- # GitHub [Developer Tools](https://flowrunner.ai/integrations/category/developer-infrastructure) Connect AI agents to GitHub via OAuth2. Agents manage repos, issues, pull requests, files, releases, organizations, teams, secrets, variables, and trigger and monitor Actions workflows. [Verified](https://flowrunner.ai/integrations/verified "What does verified mean?") · 21 triggers · 86 actions · OAuth · available [GitHub website](https://github.com/) · [Platform Documentation](https://docs.github.com/en/rest) · Capability data verified 2026-08-04 1. An On Pull Request Opened event fires for a watched repository 2. Agent reads the PR title, author, branch, and the touched files 3. Agent calls List Workflow Run Jobs to summarize check status for the branch 4. Agent posts a check summary as a PR comment with the failing jobs called out 5. Reviewers notified in Slack with the PR, the author, and the open failures 6. Merges blocked by failing checks are routed to the on-call engineer for a release decision 7. On approval, agent calls Merge Pull Request and updates the release tracker ## What This Integration Enables Agents work across the full GitHub surface: repository lifecycle (create, fork, delete, watch, star), branches (create, delete, find), files (create, update, delete, get contents and file content), issues and pull requests (create, find, update, comment, assign, label, milestone, merge), releases (create, delete), organizations and teams (members, repos, projects, secrets, variables), gists (create, delete), and webhooks. Actions workflows are first-class: trigger a workflow, list workflows and runs, get a single run, and list run jobs. Search covers issues, PRs, and repositories with GitHub's query syntax. Secrets and variables work at organization, repository, and environment scope, so an agent can rotate credentials or set environment configuration as part of a release flow. Twenty triggers fire on repository, issue, PR, release, push, star, watcher, organization, team, branch, commit, comment, label, milestone, mention, notification, gist, review request, and global events. ### Without FlowRunner **Status hidden in tabs**: PR checks, workflow runs, and release status live in separate UI tabs and chat threads **Reviewers pinged manually**: Engineers ping reviewers by hand after opening a PR or pushing a fix **Releases tracked in chat**: Release notes and approvals are scattered across DMs with no single record ### With FlowRunner **Status surfaced on event**: PR events drive a single notification with check summary, failing jobs, and author context **Reviewers pulled in automatically**: Review requests notify the right team with the change scope and risk context attached **Releases recorded as a flow**: Release-published events drive the tracker, notifications, and the audit record together ## Use Case Scenarios ### Inbound Bug Report to Issue Support reports a customer bug in chat. The agent calls Search Issues and Pull Requests with the error signature to check for duplicates. If a matching issue exists, it adds a comment with the new context; if none does, Find or Create Issue files a new one with the customer's reproduction steps, labels, and assignee. Support stops keeping a private list of "things engineering said they'd fix" and the issue tracker becomes the system of record again. ### Release Notification with Workflow Status On Release Published fires for a tagged release. The agent calls List Workflows and List Workflow Runs to confirm the release pipeline ran clean, summarizes the run outcomes, and posts the release notes to the release channel with the workflow status, the contributors, and the changelog. Anyone who needs to know what shipped reads one message instead of stitching together tabs. ### Secret Rotation on a Schedule On a schedule, the agent reads the list of repository and organization secrets via the configuration actions, identifies the ones flagged for rotation, fetches new values from the secret store, and calls Create Repository Secret or Create Organization Secret to rotate them. It posts a summary of what was rotated and what failed. Secret hygiene runs as a workflow instead of an annual fire drill. ## Human-in-Loop Highlight Merging a pull request, publishing a release, or deleting a repository is exactly where an agent should stop and ask. When a workflow is about to call Merge Pull Request on a branch with failing checks, or Delete Repository, or Create Release with a tag that touches production, the agent does not execute on its own. It stages the action and routes to the on-call engineer via Slack: "Merge PR #\[number\] into \[branch\]. Failing checks: \[list\]. Approve, request changes, or hold for review?" The engineer decides. On approval, the agent calls the action and records the decision with the approver's identity and timestamp. Routine PR comments, label adds, and check status reads flow through; anything that ships code or revokes access gets a human in the loop. Agent processes routinely Detects exception requiring judgment Clear match Continues automatically Ambiguous Routes to human via Slack Human decides Agent resumes with decision ## Agent Capabilities 86 actions ### Repositories 10 - **Create Repository** Creates a new repository. Used in project-template flows. - **Create Organization Repository** Creates a repository in an organization. Used in organization-scoped setup. - **Find Repository** Searches and retrieves a repository. Used to locate a repo before acting. - **Search Repositories** Searches repositories. Used in inventory and audit flows. - **Delete Repository** Removes a repository. Used in cleanup under approval. - **Fork Repository** Forks a repository. Used in contribution flows. - **Star Repository** Stars a repository. Used in bookkeeping. - **Unstar Repository** Unstars a repository. - **Watch Repository** Watches a repository. Used to subscribe a connected account to events. - **Unwatch Repository** Unwatches a repository. ### Branches and Files 10 - **Create Branch** Creates a branch. Used in automated branch-creation flows. - **Find Branch** Searches and retrieves a branch. - **Delete Branch** Removes a branch. Used in cleanup of merged branches. - **Create File** Creates a file. Used in scaffolding and config-write flows. - **Update File** Updates a file. Used in config-change flows. - **Delete File** Removes a file. - **Get File Content** Retrieves a file's content. Used to read code or config for downstream actions. - **Get Contents** Retrieves contents (file or directory listing). Used in directory traversal. - **Get Commit** Retrieves a single commit. Used to read commit detail. - **List Commits** Lists commits with filtering. Used in change-review flows. ### Issues 10 - **Create Issue** Creates an issue. Used in bug-intake flows. - **Find Issue** Searches and retrieves an issue. - **Find or Create Issue** Finds an existing issue or creates one if none matches. Used in duplicate-resolution flows. - **Update Issue** Updates an issue. - **Create Issue Comment** Adds a comment to an issue. - **Assign Issue/PR** Assigns an issue or pull request to a user. - **Unassign Issue/PR** Unassigns an issue or pull request. - **Add Label to Issue/PR** Adds a label to an issue or pull request. - **Remove Label from Issue/PR** Removes a label from an issue or pull request. - **Search Issues and Pull Requests** Runs a GitHub search across issues and pull requests. Used to find duplicates and survey the backlog. ### Pull Requests 4 - **Create Pull Request** Opens a pull request. Used in automated branch-flow scenarios. - **Find Pull Request** Searches and retrieves a pull request. - **Find or Create Pull Request** Finds a PR or creates one if none matches. - **Merge Pull Request** Merges a pull request. Used in approved release flows. ### Labels, Milestones, and Discussions 8 - **Create Label** Creates a label. - **Update Label** Updates a label. - **Delete Label** Removes a label. - **Create Milestone** Creates a milestone. - **Update Milestone** Updates a milestone. - **Delete Milestone** Removes a milestone. - **Create Discussion** Creates a discussion. - **Create Discussion Comment** Adds a comment to a discussion. ### Releases 2 - **Create Release** Creates a release. Used in approved release flows. - **Delete Release** Removes a release. Used in cleanup under approval. ### Organizations and Teams 13 - **Find Organization** Searches and retrieves an organization. - **Check Organization Membership** Checks whether a user is in an organization. - **Add Collaborator** Adds a collaborator to a repository. - **Remove Collaborator** Removes a collaborator. - **Create Team** Creates a team in an organization. - **Add Team Member** Adds a member to a team. - **Remove Team Member** Removes a member from a team. - **Add Team Repository** Adds a repository to a team's access list. - **Remove Team Repository** Removes a repository from a team's access list. - **Delete Team** Deletes a team. - **Create Organization Project** Creates an organization-level project. - **Create Repository Project** Creates a repository-level project. - **Delete Project** Deletes a project. ### Secrets and Variables 15 - **Create Repository Secret** Creates a repository secret. Used in credential rotation. - **Create Organization Secret** Creates an organization-level secret. - **Create Environment Secret** Creates an environment-scoped secret. - **Delete Repository Secret** Removes a repository secret. - **Delete Organization Secret** Removes an organization secret. - **Delete Environment Secret** Removes an environment secret. - **Create Repository Variable** Creates a repository variable. - **Create Organization Variable** Creates an organization variable. - **Create Environment Variable** Creates an environment variable. - **Update Repository Variable** Updates a repository variable. - **Update Organization Variable** Updates an organization variable. - **Update Environment Variable** Updates an environment variable. - **Delete Repository Variable** Removes a repository variable. - **Delete Organization Variable** Removes an organization variable. - **Delete Environment Variable** Removes an environment variable. ### Workflows (Actions) 6 - **Trigger Workflow** Triggers a GitHub Actions workflow. Used to start a workflow from another flow. - **List Workflows** Lists workflows in a repository. - **List Workflow Runs** Lists workflow runs. - **Get Workflow Run** Retrieves a single workflow run. - **List Workflow Run Jobs** Lists jobs in a workflow run. Used to summarize check status on a PR. - **Create Repository Dispatch Event** Fires a repository dispatch event. Used to trigger custom workflow patterns. ### Webhooks, Gists, and Keys 6 - **Create Repository Webhook** Creates a repository webhook. - **Delete Repository Webhook** Removes a repository webhook. - **Create Gist** Creates a gist. - **Delete Gist** Removes a gist. - **Create Deploy Key** Creates a deploy key. - **Delete Deploy Key** Removes a deploy key. ### Users 2 - **Find User** Searches and retrieves a user. - **Get Current User** Retrieves the authenticated user. Used to confirm the connected account. ## Triggers 21 triggers ### Event Triggers 21 - **On Issue Opened** Fires when a new issue is opened in a watched repository. Initiates triage flows. - **On Pull Request Opened** Fires when a new pull request is opened. Initiates review-routing flows. - **On Push** Fires on a push to a watched ref. Initiates CI and notification flows. - **On Release Published** Fires when a release is published. Initiates release-notification and tracker flows. - **On Star** Fires when a repository receives a new star. Initiates marketing or watcher flows. - **New Branch** Fires when a new branch is created. Initiates branch-tracking flows. - **New Collaborator** Fires when a new collaborator is added. Initiates access-audit flows. - **New Commit** Fires when a new commit lands. Initiates commit-tracking flows. - **New Commit Comment** Fires when a comment is added to a commit. Initiates code-review flows. - **New Gist** Fires when a new gist is created. - **New Global Event** Fires for any event on the connected account. - **New Label** Fires when a new label is created. - **New Mention** Fires when the connected account is mentioned. Initiates notification-triage flows. - **New Milestone** Fires when a new milestone is created. - **New Notification** Fires when a new notification arrives. - **New Organization** Fires when a new organization is added. - **New Repo Event** Fires on repository-scoped events. - **New Repository** Fires when a new repository is created. - **New Review Request** Fires when a review is requested on a pull request. Initiates reviewer-routing flows. - **New Team** Fires when a new team is created. - **New Watcher** Fires when a new watcher subscribes to a repository. ## Frequently Asked Questions ### What can FlowRunner do with GitHub? FlowRunner agents can run Get Current User, Create Issue, and Update Issue in GitHub, plus 83 more actions. ### Does connecting GitHub to FlowRunner require OAuth? Yes. GitHub connects to FlowRunner with OAuth 2.0, so agents authenticate without handling raw credentials. ### Can GitHub trigger a FlowRunner workflow automatically? Yes. GitHub supports 21 triggers that can start a FlowRunner workflow automatically. **Work at GitHub?** This integration exposes GitHub to AI agents on every FlowRunner plan, including through MCP, at no cost to you. [See what FlowRunner offers integration partners](https://flowrunner.ai/integrations/partners), including how to keep this page current. --- Markdown version of https://flowrunner.ai/integrations/github. Site index: https://flowrunner.ai/llms.txt