GitHub

Usage Instructions

Integrate Github into the workflow. Can get get PR details, create PR comment, get repository info, and get latest commit. Can be used in trigger mode to trigger a workflow when a PR is created, commented on, or a commit is pushed.

Tools

github_pr

Human-readable PR summary

Input

Output

github_comment

Human-readable comment confirmation

Input

Output

github_repo_info

Retrieve comprehensive GitHub repository metadata including stars, forks, issues, and primary language. Supports both public and private repositories with optional authentication.

Input

Output

github_latest_commit

Branch name (defaults to the repository

Input

Output

github_issue_comment

Human-readable comment confirmation

Input

Output

github_list_issue_comments

Human-readable comments summary

Input

Output

github_update_comment

Human-readable update confirmation

Input

Output

github_delete_comment

Human-readable deletion confirmation

Input

Output

github_list_pr_comments

Human-readable review comments summary

Input

Output

github_create_pr

Human-readable PR creation confirmation

Input

Output

github_update_pr

Human-readable PR update confirmation

Input

Output

github_merge_pr

Human-readable merge confirmation

Input

Output

github_list_prs

Filter by head user or branch name (format: user:ref-name or organization:ref-name)

Input

Output

github_get_pr_files

Human-readable list of files changed in PR

Input

Output

github_close_pr

Human-readable PR close confirmation

Input

Output

github_request_reviewers

Human-readable reviewer request confirmation

Input

Output

github_get_file_content

Get the content of a file from a GitHub repository. Supports files up to 1MB. Content is returned decoded and human-readable.

Input

Output

github_create_file

Create a new file in a GitHub repository. The file content will be automatically Base64 encoded. Supports files up to 1MB.

Input

Output

github_update_file

Update an existing file in a GitHub repository. Requires the file SHA. Content will be automatically Base64 encoded. Supports files up to 1MB.

Input

Output

github_delete_file

Delete a file from a GitHub repository. Requires the file SHA. This operation cannot be undone through the API.

Input

Output

github_get_tree

Get the contents of a directory in a GitHub repository. Returns a list of files and subdirectories. Use empty path or omit to get root directory contents.

Input

Output

github_list_branches

List all branches in a GitHub repository. Optionally filter by protected status and control pagination.

Input

Output

github_get_branch

Get detailed information about a specific branch in a GitHub repository, including commit details and protection status.

Input

Output

github_create_branch

Create a new branch in a GitHub repository by creating a git reference pointing to a specific commit SHA.

Input

Output

github_delete_branch

Delete a branch from a GitHub repository by removing its git reference. Protected branches cannot be deleted.

Input

Output

github_get_branch_protection

Get the branch protection rules for a specific branch, including status checks, review requirements, and restrictions.

Input

Output

github_update_branch_protection

Update branch protection rules for a specific branch, including status checks, review requirements, admin enforcement, and push restrictions.

Input

Output

github_create_issue

Human-readable issue creation confirmation

Input

Output

github_update_issue

Human-readable issue update confirmation

Input

Output

github_list_issues

List issues in a GitHub repository. Note: This includes pull requests as PRs are considered issues in GitHub

Input

Output

github_get_issue

Human-readable issue details

Input

Output

github_close_issue

Human-readable issue close confirmation

Input

Output

github_add_labels

Human-readable labels confirmation

Input

Output

github_remove_label

Human-readable label removal confirmation

Input

Output

github_add_assignees

Human-readable assignees confirmation

Input

Output

github_create_release

Create a new release for a GitHub repository. Specify tag name, target commit, title, description, and whether it should be a draft or prerelease.

Input

Output

github_update_release

Update an existing GitHub release. Modify tag name, target commit, title, description, draft status, or prerelease status.

Input

Output

github_list_releases

List all releases for a GitHub repository. Returns release information including tags, names, and download URLs.

Input

Output

github_get_release

Get detailed information about a specific GitHub release by ID. Returns release metadata including assets and download URLs.

Input

Output

github_delete_release

Delete a GitHub release by ID. This permanently removes the release but does not delete the associated Git tag.

Input

Output

github_list_workflows

List all workflows in a GitHub repository. Returns workflow details including ID, name, path, state, and badge URL.

Input

Output

github_get_workflow

Get details of a specific GitHub Actions workflow by ID or filename. Returns workflow information including name, path, state, and badge URL.

Input

Output

github_trigger_workflow

Trigger a workflow dispatch event for a GitHub Actions workflow. The workflow must have a workflow_dispatch trigger configured. Returns 204 No Content on success.

Input

Output

github_list_workflow_runs

List workflow runs for a repository. Supports filtering by actor, branch, event, and status. Returns run details including status, conclusion, and links.

Input

Output

github_get_workflow_run

Get detailed information about a specific workflow run by ID. Returns status, conclusion, timing, and links to the run.

Input

Output

github_cancel_workflow_run

Cancel a workflow run. Returns 202 Accepted if cancellation is initiated, or 409 Conflict if the run cannot be cancelled (already completed).

Input

Output

github_rerun_workflow

Rerun a workflow run. Optionally enable debug logging for the rerun. Returns 201 Created on success.

Input

Output

github_list_projects

List GitHub Projects V2 for an organization or user. Returns up to 20 projects with their details including ID, title, number, URL, and status.

Input

Output

github_get_project

Get detailed information about a specific GitHub Project V2 by its number. Returns project details including ID, title, description, URL, and status.

Input

Output

github_create_project

Create a new GitHub Project V2. Requires the owner Node ID (not login name). Returns the created project with ID, title, and URL.

Input

Output

github_update_project

Update an existing GitHub Project V2. Can update title, description, visibility (public), or status (closed). Requires the project Node ID.

Input

Output

github_delete_project

Delete a GitHub Project V2. This action is permanent and cannot be undone. Requires the project Node ID.

Input

Output

github_search_code

Search for code across GitHub repositories. Use qualifiers like repo:owner/name, language:js, path:src, extension:py

Input

Output

github_search_commits

Search for commits across GitHub. Use qualifiers like repo:owner/name, author:user, committer:user, author-date:>2023-01-01

Input

Output

github_search_issues

Search for issues and pull requests across GitHub. Use qualifiers like repo:owner/name, is:issue, is:pr, state:open, label:bug, author:user

Input

Output

github_search_repos

Search for repositories across GitHub. Use qualifiers like language:python, stars:>1000, topic:react, user:owner, org:name

Input

Output

github_search_users

Search for users and organizations on GitHub. Use qualifiers like type:user, type:org, followers:>1000, repos:>10, location:city

Input

Output

github_list_commits

List commits in a repository with optional filtering by SHA, path, author, committer, or date range

Input

Output

github_get_commit

Human-readable commit details

Input

Output

github_compare_commits

Compare two commits or branches to see the diff, commits between them, and changed files

Input

Output

github_create_gist

JSON object with filenames as keys and content as values. Example: {

Input

Output

github_get_gist

Human-readable gist with file contents

Input

Output

github_list_gists

GitHub username (omit for authenticated user

Input

Output

github_update_gist

Update a gist description or files. To delete a file, set its value to null in files object

Input

Output

github_delete_gist

Human-readable result

Input

Output

github_fork_gist

Human-readable result

Input

Output

github_star_gist

Human-readable result

Input

Output

github_unstar_gist

Human-readable result

Input

Output

github_fork_repo

Human-readable result

Input

Output

github_list_forks

Human-readable fork list

Input

Output

github_create_milestone

Human-readable result

Input

Output

github_get_milestone

Human-readable milestone details

Input

Output

github_list_milestones

Human-readable milestone list

Input

Output

github_update_milestone

Human-readable result

Input

Output

github_delete_milestone

Human-readable result

Input

Output

github_create_issue_reaction

Reaction type: +1 (thumbs up), -1 (thumbs down), laugh, confused, heart, hooray, rocket, eyes

Input

Output

github_delete_issue_reaction

Human-readable result

Input

Output

github_create_comment_reaction

Reaction type: +1 (thumbs up), -1 (thumbs down), laugh, confused, heart, hooray, rocket, eyes

Input

Output

github_delete_comment_reaction

Human-readable result

Input

Output

github_star_repo

Human-readable result

Input

Output

github_unstar_repo

Human-readable result

Input

Output

github_check_star

Human-readable result

Input

Output

github_list_stargazers

Human-readable stargazer list

Input

Output