Skip to main content
Server path: /github | Type: Application | PCID required: Yes Repos, issues, and pull requests

Tools

ToolDescription
github_create_issueCreate a new issue in a GitHub repository
github_create_pull_requestCreate a new pull request in a GitHub repository
github_get_repositoryGet information about a GitHub repository
github_list_issuesList issues in a GitHub repository
github_get_issueGet a specific issue by number
github_update_issueUpdate an existing GitHub issue
github_create_issue_commentAdd a comment to a GitHub issue
github_list_pull_requestsList pull requests in a GitHub repository
github_get_pull_requestGet a specific pull request by number
github_create_repositoryCreate a new GitHub repository
github_list_repositoriesList repositories for the authenticated user
github_get_file_contentGet the content of a file from a GitHub repository
github_create_or_update_fileCreate or update a file in a GitHub repository
github_list_commitsList commits in a GitHub repository
github_get_current_userGet information about the authenticated user
github_search_repositoriesSearch for repositories on GitHub
github_create_branchCreate a new branch in a GitHub repository
github_list_trigger_capabilitiesList available trigger types that can be created for GitHub webhooks
github_create_triggerCreate a GitHub webhook that will send events
github_update_triggerUpdate an existing GitHub webhook (only supports updating events list)
github_delete_triggerDelete a GitHub webhook

github_create_issue

Create a new issue in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner (username or organization). Tip: Use github_list_repositories to see repositories you have access to.
repostringYesRepository name. Tip: Use github_list_repositories or github_search_repositories to discover available repositories.
titlestringYesIssue title
bodystringNoIssue description/body
assigneesstring[]NoArray of usernames to assign. Tip: Use github_get_current_user to get your username.
labelsstring[]NoArray of label names to apply (label names, not IDs)
milestonenumberNoMilestone number to associate with issue

github_create_pull_request

Create a new pull request in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
titlestringYesPull request title
headstringYesBranch with changes (e.g., “feature-branch”)
basestringYesBase branch to merge into (e.g., “main”)
bodystringNoPull request description
draftbooleanNofalseCreate as draft PR
maintainerCanModifybooleanNotrueAllow maintainers to modify PR

github_get_repository

Get information about a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name

github_list_issues

List issues in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
statestringNo"open"Issue state filter
assigneestringNoFilter by assignee username
labelsstringNoComma-separated list of label names
sortstringNo"created"Sort field
directionstringNo"desc"Sort direction
perPagenumberNo30Number of results per page

github_get_issue

Get a specific issue by number Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
issueNumbernumberYesIssue number

github_update_issue

Update an existing GitHub issue Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
issueNumbernumberYesIssue number to update
titlestringNoUpdated issue title
bodystringNoUpdated issue body
statestringNoUpdated issue state
assigneesstring[]NoUpdated assignees
labelsstring[]NoUpdated labels

github_create_issue_comment

Add a comment to a GitHub issue Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
issueNumbernumberYesIssue number to comment on
bodystringYesComment text

github_list_pull_requests

List pull requests in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
statestringNo"open"PR state filter
headstringNoFilter by head branch
basestringNoFilter by base branch
sortstringNo"created"Sort field
directionstringNo"desc"Sort direction
perPagenumberNo30Number of results per page

github_get_pull_request

Get a specific pull request by number Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pullNumbernumberYesPull request number

github_create_repository

Create a new GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesRepository name
descriptionstringNoRepository description
privatebooleanNofalseWhether repository is private
autoInitbooleanNofalseInitialize with README
gitignoreTemplatestringNoGitignore template to use
licenseTemplatestringNoLicense template to use

github_list_repositories

List repositories for the authenticated user Parameters:
ParameterTypeRequiredDefaultDescription
visibilitystringNo"all"Repository visibility filter
sortstringNo"created"Sort field
directionstringNo"desc"Sort direction
perPagenumberNo30Number of results per page

github_get_file_content

Get the content of a file from a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pathstringYesFile path in repository
refstringNoBranch, tag, or commit SHA (defaults to default branch)

github_create_or_update_file

Create or update a file in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
pathstringYesFile path in repository
messagestringYesCommit message
contentstringYesFile content (will be base64 encoded)
branchstringNoBranch to commit to (defaults to default branch)
shastringNoSHA of existing file (required for updates)

github_list_commits

List commits in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
shastringNoSHA or branch to start listing from
pathstringNoFilter commits by file path
authorstringNoFilter commits by author
sincestringNoOnly commits after this date (ISO 8601)
untilstringNoOnly commits before this date (ISO 8601)
perPagenumberNo30Number of results per page

github_get_current_user

Get information about the authenticated user

github_search_repositories

Search for repositories on GitHub Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesSearch query (e.g., “language:javascript”, “user:octocat”)
sortstringNoSort field
orderstringNo"desc"Sort order
perPagenumberNo30Number of results per page

github_create_branch

Create a new branch in a GitHub repository Parameters:
ParameterTypeRequiredDefaultDescription
ownerstringYesRepository owner
repostringYesRepository name
branchNamestringYesName for the new branch
fromBranchstringNo"main"Source branch to create from

github_list_trigger_capabilities

List available trigger types that can be created for GitHub webhooks

github_create_trigger

Create a GitHub webhook that will send events Parameters:
ParameterTypeRequiredDefaultDescription
triggerTypestringYesType of trigger to create
webhookUrlstringYesThe webhook URL where GitHub should send events
repositorystringYesRepository in owner/name format (e.g., “octocat/hello-world”). Tip: Use github_list_repositories to see repositories you have access to.
eventsanyYesEvent types to subscribe to. Common: push, pull_request, issues, issue_comment, release. Can be passed as JSON string array or array.
secretstringNoOptional webhook secret for signature verification (auto-generated if not provided)

github_update_trigger

Update an existing GitHub webhook (only supports updating events list) Parameters:
ParameterTypeRequiredDefaultDescription
webhookIdstringYesThe GitHub webhook ID to update
ownerstringYesRepository owner (username or organization). Tip: Use github_list_repositories to see repositories you have access to.
repostringYesRepository name. Tip: Use github_list_repositories to find the repository.
eventsanyYesArray of event types to subscribe to. Can be passed as JSON string array or array.
activebooleanNotrueWhether the webhook is active

github_delete_trigger

Delete a GitHub webhook Parameters:
ParameterTypeRequiredDefaultDescription
triggerIdstringYesThe ID of the webhook to delete
ownerstringNoRepository owner (required if not in metadata from trigger creation)
repostringNoRepository name (required if not in metadata from trigger creation)
webhookIdstringNoOptional webhook ID (if not provided, will use triggerId)