GitHub

github/github-mcp-serverOfficial

The GitHub MCP Server enables AI agents and assistants to interact with GitHub's platform through natural language, providing tools to browse and analyze repositories, manage issues and pull requests, monitor CI/CD workflows, review code security findings, and access team collaboration features. It solves the problem of connecting AI tools to GitHub context without requiring manual API integration, allowing developers to automate repository management, code analysis, and development workflows through conversational interfaces. The server is available as both a remote hosted service and a local installation option, supporting various MCP-compatible hosts including VS Code, Claude Desktop, and other AI development tools.

GitHub stars: 34.3K
tools: 80
auth: Secret needed
transport: STDIO, HTTP
last updated: Nov 3, 2026

View on GitHub

Tools

80 tools

Public tool metadata for what this MCP can expose to an agent.

actions_getGet details about specific GitHub Actions resources. Use this tool to get details about individual workflows, workflow runs, jobs, and artifacts by their unique IDs.4 params

Get details about specific GitHub Actions resources. Use this tool to get details about individual workflows, workflow runs, jobs, and artifacts by their unique IDs.

Parameters* required

methodstring

The method to executeone of

get_workflow · get_workflow_run · get_workflow_job · download_workflow_run_artifact · get_workflow_run_usage · get_workflow_run_logs_url

ownerstring

Repository owner

repostring

Repository name

resource_idstring

The unique identifier of the resource. This will vary based on the "method" provided, so ensure you provide the correct ID: - Provide a workflow ID or workflow file name (e.g. ci.yaml) for 'get_wor...

actions_listTools for listing GitHub Actions resources. Use this tool to list workflows in a repository, or list workflow runs, jobs, and artifacts for a specific workflow or workflow run.8 params

Tools for listing GitHub Actions resources. Use this tool to list workflows in a repository, or list workflow runs, jobs, and artifacts for a specific workflow or workflow run.

Parameters* required

methodstring

The action to performone of list_workflows · list_workflow_runs · list_workflow_jobs · list_workflow_run_artifacts

ownerstring

Repository owner

pagenumber

Page number for pagination (default: 1)

per_pagenumber

Results per page for pagination (default: 30, max: 100)

repostring

Repository name

resource_idstring

The unique identifier of the resource. This will vary based on the "method" provided, so ensure you provide the correct ID: - Do not provide any resource ID for 'list_workflows' method. - Provide a...

workflow_jobs_filterobject

Filters for workflow jobs. **ONLY** used when method is 'list_workflow_jobs'

workflow_runs_filterobject

Filters for workflow runs. **ONLY** used when method is 'list_workflow_runs'

actions_run_triggerTrigger GitHub Actions workflow operations, including running, re-running, cancelling workflow runs, and deleting workflow run logs.7 params

Trigger GitHub Actions workflow operations, including running, re-running, cancelling workflow runs, and deleting workflow run logs.

Parameters* required

inputsobject

Inputs the workflow accepts. Only used for 'run_workflow' method.

methodstring

The method to executeone of run_workflow · rerun_workflow_run · rerun_failed_jobs · cancel_workflow_run · delete_workflow_run_logs

ownerstring

Repository owner

refstring

The git reference for the workflow. The reference can be a branch or tag name. Required for 'run_workflow' method.

repostring

Repository name

run_idnumber

The ID of the workflow run. Required for all methods except 'run_workflow'.

workflow_idstring

The workflow ID (numeric) or workflow file name (e.g., main.yml, ci.yaml). Required for 'run_workflow' method.

add_comment_to_pending_reviewAdd review comment to the requester's latest pending pull request review. A pending review needs to already exist to call this (check with the user if not sure).10 params

Add review comment to the requester's latest pending pull request review. A pending review needs to already exist to call this (check with the user if not sure).

Parameters* required

bodystring

The text of the review comment

linenumber

The line of the blob in the pull request diff that the comment applies to. For multi-line comments, the last line of the range

ownerstring

Repository owner

pathstring

The relative path to the file that necessitates a comment

pullNumbernumber

Pull request number

repostring

Repository name

sidestring

The side of the diff to comment on. LEFT indicates the previous state, RIGHT indicates the new stateone of LEFT · RIGHT

startLinenumber

For multi-line comments, the first line of the range that the comment applies to

startSidestring

For multi-line comments, the starting side of the diff that the comment applies to. LEFT indicates the previous state, RIGHT indicates the new stateone of LEFT · RIGHT

subjectTypestring

The level at which the comment is targetedone of FILE · LINE

add_issue_commentAdd a comment to a specific issue in a GitHub repository. Use this tool to add comments to pull requests as well (in this case pass pull request number as issue_number), but only if user is not asking specifically to add review comments.4 params

Add a comment to a specific issue in a GitHub repository. Use this tool to add comments to pull requests as well (in this case pass pull request number as issue_number), but only if user is not asking specifically to add review comments.

Parameters* required

bodystring

Comment content

issue_numbernumber

Issue number to comment on

ownerstring

Repository owner

repostring

Repository name

add_reply_to_pull_request_commentAdd a reply to an existing pull request comment. This creates a new comment that is linked as a reply to the specified comment.5 params

Add a reply to an existing pull request comment. This creates a new comment that is linked as a reply to the specified comment.

Parameters* required

bodystring

The text of the reply

commentIdnumber

The ID of the comment to reply to

ownerstring

Repository owner

pullNumbernumber

Pull request number

repostring

Repository name

assign_copilot_to_issueAssign Copilot to a specific issue in a GitHub repository. This tool can help with the following outcomes: - a Pull Request created with source code changes to resolve the issue More information can be found at: - https://docs.github.com/en/copilot/using-github-copilot/using-c...5 params

Assign Copilot to a specific issue in a GitHub repository. This tool can help with the following outcomes: - a Pull Request created with source code changes to resolve the issue More information can be found at: - https://docs.github.com/en/copilot/using-github-copilot/using-c...

Parameters* required

base_refstring

Git reference (e.g., branch) that the agent will start its work from. If not specified, defaults to the repository's default branch

custom_instructionsstring

Optional custom instructions to guide the agent beyond the issue body. Use this to provide additional context, constraints, or guidance that is not captured in the issue description

issue_numbernumber

Issue number

ownerstring

Repository owner

repostring

Repository name

create_branchCreate a new branch in a GitHub repository4 params

Create a new branch in a GitHub repository

Parameters* required

branchstring

Name for new branch

from_branchstring

Source branch (defaults to repo default)

ownerstring

Repository owner

repostring

Repository name

create_gistCreate a new gist4 params

Create a new gist

Parameters* required

contentstring

Content for simple single-file gist creation

descriptionstring

Description of the gist

filenamestring

Filename for simple single-file gist creation

publicboolean

Whether the gist is publicdefault: false

create_or_update_fileCreate or update a single file in a GitHub repository. If updating, you should provide the SHA of the file you want to update. Use this tool to create or update a file in a GitHub repository remotely; do not use it for local file operations. In order to obtain the SHA of origi...7 params

Create or update a single file in a GitHub repository. If updating, you should provide the SHA of the file you want to update. Use this tool to create or update a file in a GitHub repository remotely; do not use it for local file operations. In order to obtain the SHA of origi...

Parameters* required

branchstring

Branch to create/update the file in

contentstring

Content of the file

messagestring

Commit message

ownerstring

Repository owner (username or organization)

pathstring

Path where to create/update the file

repostring

Repository name

shastring

The blob SHA of the file being replaced. Required if the file already exists.

create_pull_requestCreate a new pull request in a GitHub repository.8 params

Create a new pull request in a GitHub repository.

Parameters* required

basestring

Branch to merge into

bodystring

PR description

draftboolean

Create as draft PR

headstring

Branch containing changes

maintainer_can_modifyboolean

Allow maintainer edits

ownerstring

Repository owner

repostring

Repository name

titlestring

PR title

create_pull_request_with_copilotDelegate a task to GitHub Copilot coding agent to perform in the background. The agent will create a pull request with the implementation. You should use this tool if the user asks to create a pull request to perform a specific task, or if the user asks Copilot to do something.5 params

Delegate a task to GitHub Copilot coding agent to perform in the background. The agent will create a pull request with the implementation. You should use this tool if the user asks to create a pull request to perform a specific task, or if the user asks Copilot to do something.

Parameters* required

base_refstring

Git reference (e.g., branch) that the agent will start its work from. If not specified, defaults to the repository's default branch

ownerstring

Repository owner. You can guess the owner, but confirm it with the user before proceeding.

problem_statementstring

Detailed description of the task to be performed (e.g., 'Implement a feature that does X', 'Fix bug Y', etc.)

repostring

Repository name. You can guess the repository name, but confirm it with the user before proceeding.

titlestring

Title for the pull request that will be created

create_repositoryCreate a new GitHub repository in your account or specified organization5 params

Create a new GitHub repository in your account or specified organization

Parameters* required

autoInitboolean

Initialize with README

descriptionstring

Repository description

namestring

Repository name

organizationstring

Organization to create the repository in (omit to create in your personal account)

privateboolean

Whether repo should be private

delete_fileDelete a file from a GitHub repository5 params

Delete a file from a GitHub repository

Parameters* required

branchstring

Branch to delete the file from

messagestring

Commit message

ownerstring

Repository owner (username or organization)

pathstring

Path to the file to delete

repostring

Repository name

dismiss_notificationDismiss a notification by marking it as read or done2 params

Dismiss a notification by marking it as read or done

Parameters* required

statestring

The new state of the notification (read/done)one of read · done

threadIDstring

The ID of the notification thread

fork_repositoryFork a GitHub repository to your account or specified organization3 params

Fork a GitHub repository to your account or specified organization

Parameters* required

organizationstring

Organization to fork to

ownerstring

Repository owner

repostring

Repository name

get_code_scanning_alertGet details of a specific code scanning alert in a GitHub repository.3 params

Get details of a specific code scanning alert in a GitHub repository.

Parameters* required

alertNumbernumber

The number of the alert.

ownerstring

The owner of the repository.

repostring

The name of the repository.

get_commitGet details for a commit from a GitHub repository6 params

Get details for a commit from a GitHub repository

Parameters* required

include_diffboolean

Whether to include file diffs and stats in the response. Default is true.default: true

ownerstring

Repository owner

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Repository name

shastring

Commit SHA, branch name, or tag name

get_copilot_job_statusGet the status of a GitHub Copilot coding agent job. Use this to check if a previously submitted task has completed and to get the pull request URL once it's created. Provide the job ID (from create_pull_request_with_copilot) or pull request number (from assign_copilot_to_issu...3 params

Get the status of a GitHub Copilot coding agent job. Use this to check if a previously submitted task has completed and to get the pull request URL once it's created. Provide the job ID (from create_pull_request_with_copilot) or pull request number (from assign_copilot_to_issu...

Parameters* required

idstring

Job ID or pull request number

ownerstring

Repository owner

repostring

Repository name

get_copilot_spaceThis tool can be used to provide additional context to the chat from a specific Copilot space. If the user mentions the keyword 'Copilot space' with the name and owner of the space, execute this tool. The response includes a table of contents (TOC) listing all documents in the...2 params

This tool can be used to provide additional context to the chat from a specific Copilot space. If the user mentions the keyword 'Copilot space' with the name and owner of the space, execute this tool. The response includes a table of contents (TOC) listing all documents in the...

Parameters* required

namestring

The name of the space

ownerstring

The owner of the space

get_dependabot_alertGet details of a specific dependabot alert in a GitHub repository.3 params

Get details of a specific dependabot alert in a GitHub repository.

Parameters* required

alertNumbernumber

The number of the alert.

ownerstring

The owner of the repository.

repostring

The name of the repository.

get_discussionGet a specific discussion by ID3 params

Get a specific discussion by ID

Parameters* required

discussionNumbernumber

Discussion Number

ownerstring

Repository owner

repostring

Repository name

get_discussion_commentsGet comments from a discussion5 params

Get comments from a discussion

Parameters* required

afterstring

Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs.

discussionNumbernumber

Discussion Number

ownerstring

Repository owner

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Repository name

get_file_contentsGet the contents of a file or directory from a GitHub repository5 params

Get the contents of a file or directory from a GitHub repository

Parameters* required

ownerstring

Repository owner (username or organization)

pathstring

Path to file/directorydefault: /

refstring

Accepts optional git refs such as `refs/tags/{tag}`, `refs/heads/{branch}` or `refs/pull/{pr_number}/head`

repostring

Repository name

shastring

Accepts optional commit SHA. If specified, it will be used instead of ref

get_gistGet gist content of a particular gist, by gist ID1 params

Get gist content of a particular gist, by gist ID

Parameters* required

gist_idstring

The ID of the gist

get_global_security_advisoryGet a global security advisory1 params

Get a global security advisory

Parameters* required

ghsaIdstring

GitHub Security Advisory ID (format: GHSA-xxxx-xxxx-xxxx).

get_job_logsGet logs for GitHub Actions workflow jobs. Use this tool to retrieve logs for a specific job or all failed jobs in a workflow run. For single job logs, provide job_id. For all failed jobs in a run, provide run_id with failed_only=true.7 params

Get logs for GitHub Actions workflow jobs. Use this tool to retrieve logs for a specific job or all failed jobs in a workflow run. For single job logs, provide job_id. For all failed jobs in a run, provide run_id with failed_only=true.

Parameters* required

failed_onlyboolean

When true, gets logs for all failed jobs in the workflow run specified by run_id. Requires run_id to be provided.

job_idnumber

The unique identifier of the workflow job. Required when getting logs for a single job.

ownerstring

Repository owner

repostring

Repository name

return_contentboolean

Returns actual log content instead of URLs

run_idnumber

The unique identifier of the workflow run. Required when failed_only is true to get logs for all failed jobs in the run.

tail_linesnumber

Number of lines to return from the end of the logdefault: 500

get_labelGet a specific label from a repository.3 params

Get a specific label from a repository.

Parameters* required

namestring

Label name.

ownerstring

Repository owner (username or organization name)

repostring

Repository name

get_latest_releaseGet the latest release in a GitHub repository2 params

Get the latest release in a GitHub repository

Parameters* required

ownerstring

Repository owner

repostring

Repository name

get_meGet details of the authenticated GitHub user. Use this when a request is about the user's own profile for GitHub. Or when information is missing to build other tool calls.

Get details of the authenticated GitHub user. Use this when a request is about the user's own profile for GitHub. Or when information is missing to build other tool calls.

No parameter schema in public metadata yet.

get_notification_detailsGet detailed information for a specific GitHub notification, always call this tool when the user asks for details about a specific notification, if you don't know the ID list notifications first.1 params

Get detailed information for a specific GitHub notification, always call this tool when the user asks for details about a specific notification, if you don't know the ID list notifications first.

Parameters* required

notificationIDstring

The ID of the notification

get_release_by_tagGet a specific release by its tag name in a GitHub repository3 params

Get a specific release by its tag name in a GitHub repository

Parameters* required

ownerstring

Repository owner

repostring

Repository name

tagstring

Tag name (e.g., 'v1.0.0')

get_repository_treeGet the tree structure (files and directories) of a GitHub repository at a specific ref or SHA5 params

Get the tree structure (files and directories) of a GitHub repository at a specific ref or SHA

Parameters* required

ownerstring

Repository owner (username or organization)

path_filterstring

Optional path prefix to filter the tree results (e.g., 'src/' to only show files in the src directory)

recursiveboolean

Setting this parameter to true returns the objects or subtrees referenced by the tree. Default is falsedefault: false

repostring

Repository name

tree_shastring

The SHA1 value or ref (branch or tag) name of the tree. Defaults to the repository's default branch

get_secret_scanning_alertGet details of a specific secret scanning alert in a GitHub repository.3 params

Get details of a specific secret scanning alert in a GitHub repository.

Parameters* required

alertNumbernumber

The number of the alert.

ownerstring

The owner of the repository.

repostring

The name of the repository.

get_tagGet details about a specific git tag in a GitHub repository3 params

Get details about a specific git tag in a GitHub repository

Parameters* required

ownerstring

Repository owner

repostring

Repository name

tagstring

Tag name

get_team_membersGet member usernames of a specific team in an organization. Limited to organizations accessible with current credentials2 params

Get member usernames of a specific team in an organization. Limited to organizations accessible with current credentials

Parameters* required

orgstring

Organization login (owner) that contains the team.

team_slugstring

Team slug

get_teamsGet details of the teams the user is a member of. Limited to organizations accessible with current credentials1 params

Get details of the teams the user is a member of. Limited to organizations accessible with current credentials

Parameters* required

userstring

Username to get teams for. If not provided, uses the authenticated user.

github_support_docs_searchRetrieve documentation relevant to answer GitHub product and support questions. Support topics include: GitHub Actions Workflows, Authentication, GitHub Support Inquiries, Pull Request Practices, Repository Maintenance, GitHub Pages, GitHub Packages, GitHub Discussions, Copilo...1 params

Retrieve documentation relevant to answer GitHub product and support questions. Support topics include: GitHub Actions Workflows, Authentication, GitHub Support Inquiries, Pull Request Practices, Repository Maintenance, GitHub Pages, GitHub Packages, GitHub Discussions, Copilo...

Parameters* required

querystring

Input from the user about the question they need answered. This is the latest raw unedited user message. You should ALWAYS leave the user message as it is, you should never modify it.

issue_readGet information about a specific issue in a GitHub repository.6 params

Get information about a specific issue in a GitHub repository.

Parameters* required

issue_numbernumber

The number of the issue

methodstring

The read operation to perform on a single issue. Options are: 1. get - Get details of a specific issue. 2. get_comments - Get issue comments. 3. get_sub_issues - Get sub-issues of the issue. 4. get...one of get · get_comments · get_sub_issues · get_labels

ownerstring

The owner of the repository

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

The name of the repository

issue_writeCreate a new or update an existing issue in a GitHub repository.13 params

Create a new or update an existing issue in a GitHub repository.

Parameters* required

assigneesarray

Usernames to assign to this issue

bodystring

Issue body content

duplicate_ofnumber

Issue number that this issue is a duplicate of. Only used when state_reason is 'duplicate'.

issue_numbernumber

Issue number to update

labelsarray

Labels to apply to this issue

methodstring

Write operation to perform on a single issue. Options are: - 'create' - creates a new issue. - 'update' - updates an existing issue. one of create · update

milestonenumber

Milestone number

ownerstring

Repository owner

repostring

Repository name

statestring

New stateone of open · closed

state_reasonstring

Reason for the state change. Ignored unless state is changed.one of completed · not_planned · duplicate

titlestring

Issue title

typestring

Type of this issue. Only use if the repository has issue types configured. Use list_issue_types tool to get valid type values for the organization. If the repository doesn't support issue types, om...

label_writePerform write operations on repository labels. To set labels on issues, use the 'update_issue' tool.7 params

Perform write operations on repository labels. To set labels on issues, use the 'update_issue' tool.

Parameters* required

colorstring

Label color as 6-character hex code without '#' prefix (e.g., 'f29513'). Required for 'create', optional for 'update'.

descriptionstring

Label description text. Optional for 'create' and 'update'.

methodstring

Operation to perform: 'create', 'update', or 'delete'one of create · update · delete

namestring

Label name - required for all operations

new_namestring

New name for the label (used only with 'update' method to rename)

ownerstring

Repository owner (username or organization name)

repostring

Repository name

list_branchesList branches in a GitHub repository4 params

List branches in a GitHub repository

Parameters* required

ownerstring

Repository owner

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Repository name

list_code_scanning_alertsList code scanning alerts in a GitHub repository.6 params

List code scanning alerts in a GitHub repository.

Parameters* required

ownerstring

The owner of the repository.

refstring

The Git reference for the results you want to list.

repostring

The name of the repository.

severitystring

Filter code scanning alerts by severityone of critical · high · medium · low · warning · note

statestring

Filter code scanning alerts by state. Defaults to openone of open · closed · dismissed · fixeddefault: open

tool_namestring

The name of the tool used for code scanning.

list_commitsGet list of commits of a branch in a GitHub repository. Returns at least 30 results per page by default, but can return more if specified using the perPage parameter (up to 100).6 params

Get list of commits of a branch in a GitHub repository. Returns at least 30 results per page by default, but can return more if specified using the perPage parameter (up to 100).

Parameters* required

authorstring

Author username or email address to filter commits by

ownerstring

Repository owner

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Repository name

shastring

Commit SHA, branch or tag name to list commits of. If not provided, uses the default branch of the repository. If a commit SHA is provided, will list commits up to that SHA.

list_copilot_spacesRetrieves the list of Copilot Spaces accessible to the user, including their names and owners.

Retrieves the list of Copilot Spaces accessible to the user, including their names and owners.

No parameter schema in public metadata yet.

list_dependabot_alertsList dependabot alerts in a GitHub repository.4 params

List dependabot alerts in a GitHub repository.

Parameters* required

ownerstring

The owner of the repository.

repostring

The name of the repository.

severitystring

Filter dependabot alerts by severityone of low · medium · high · critical

statestring

Filter dependabot alerts by state. Defaults to openone of open · fixed · dismissed · auto_dismisseddefault: open

list_discussion_categoriesList discussion categories with their id and name, for a repository or organisation.2 params

List discussion categories with their id and name, for a repository or organisation.

Parameters* required

ownerstring

Repository owner

repostring

Repository name. If not provided, discussion categories will be queried at the organisation level.

list_discussionsList discussions for a repository or organisation.7 params

List discussions for a repository or organisation.

Parameters* required

afterstring

Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs.

categorystring

Optional filter by discussion category ID. If provided, only discussions with this category are listed.

directionstring

Order direction.one of ASC · DESC

orderBystring

Order discussions by field. If provided, the 'direction' also needs to be provided.one of CREATED_AT · UPDATED_AT

ownerstring

Repository owner

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Repository name. If not provided, discussions will be queried at the organisation level.

list_gistsList gists for a user4 params

List gists for a user

Parameters* required

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

sincestring

Only gists updated after this time (ISO 8601 timestamp)

usernamestring

GitHub username (omit for authenticated user's gists)

list_global_security_advisoriesList global security advisories from GitHub.11 params

List global security advisories from GitHub.

Parameters* required

affectsstring

Filter advisories by affected package or version (e.g. "package1,package2@1.0.0").

cveIdstring

Filter by CVE ID.

cwesarray

Filter by Common Weakness Enumeration IDs (e.g. ["79", "284", "22"]).

ecosystemstring

Filter by package ecosystem.one of actions · composer · erlang · go · maven · npm

ghsaIdstring

Filter by GitHub Security Advisory ID (format: GHSA-xxxx-xxxx-xxxx).

isWithdrawnboolean

Whether to only return withdrawn advisories.

modifiedstring

Filter by publish or update date or date range (ISO 8601 date or range).

publishedstring

Filter by publish date or date range (ISO 8601 date or range).

severitystring

Filter by severity.one of unknown · low · medium · high · critical

typestring

Advisory type.one of reviewed · malware · unrevieweddefault: reviewed

updatedstring

Filter by update date or date range (ISO 8601 date or range).

list_issue_typesList supported issue types for repository owner (organization).1 params

List supported issue types for repository owner (organization).

Parameters* required

ownerstring

The organization owner of the repository

list_issuesList issues in a GitHub repository. For pagination, use the 'endCursor' from the previous response's 'pageInfo' in the 'after' parameter.9 params

List issues in a GitHub repository. For pagination, use the 'endCursor' from the previous response's 'pageInfo' in the 'after' parameter.

Parameters* required

afterstring

Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs.

directionstring

Order direction. If provided, the 'orderBy' also needs to be provided.one of ASC · DESC

labelsarray

Filter by labels

orderBystring

Order issues by field. If provided, the 'direction' also needs to be provided.one of CREATED_AT · UPDATED_AT · COMMENTS

ownerstring

Repository owner

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Repository name

sincestring

Filter by date (ISO 8601 timestamp)

statestring

Filter by state, by default both open and closed issues are returned when not providedone of OPEN · CLOSED

list_labelList labels from a repository2 params

List labels from a repository

Parameters* required

ownerstring

Repository owner (username or organization name) - required for all operations

repostring

Repository name - required for all operations

list_notificationsLists all GitHub notifications for the authenticated user, including unread notifications, mentions, review requests, assignments, and updates on issues or pull requests. Use this tool whenever the user asks what to work on next, requests a summary of their GitHub activity, wa...7 params

Lists all GitHub notifications for the authenticated user, including unread notifications, mentions, review requests, assignments, and updates on issues or pull requests. Use this tool whenever the user asks what to work on next, requests a summary of their GitHub activity, wa...

Parameters* required

beforestring

Only show notifications updated before the given time (ISO 8601 format)

filterstring

Filter notifications to, use default unless specified. Read notifications are ones that have already been acknowledged by the user. Participating notifications are those that the user is directly i...one of default · include_read_notifications · only_participating

ownerstring

Optional repository owner. If provided with repo, only notifications for this repository are listed.

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Optional repository name. If provided with owner, only notifications for this repository are listed.

sincestring

Only show notifications updated after the given time (ISO 8601 format)

list_org_repository_security_advisoriesList repository security advisories for a GitHub organization.4 params

List repository security advisories for a GitHub organization.

Parameters* required

directionstring

Sort direction.one of asc · desc

orgstring

The organization login.

sortstring

Sort field.one of created · updated · published

statestring

Filter by advisory state.one of triage · draft · published · closed

list_pull_requestsList pull requests in a GitHub repository. If the user specifies an author, then DO NOT use this tool and use the search_pull_requests tool instead.9 params

List pull requests in a GitHub repository. If the user specifies an author, then DO NOT use this tool and use the search_pull_requests tool instead.

Parameters* required

basestring

Filter by base branch

directionstring

Sort directionone of asc · desc

headstring

Filter by head user/org and branch

ownerstring

Repository owner

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Repository name

sortstring

Sort byone of created · updated · popularity · long-running

statestring

Filter by stateone of open · closed · all

list_releasesList releases in a GitHub repository4 params

List releases in a GitHub repository

Parameters* required

ownerstring

Repository owner

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Repository name

list_repository_security_advisoriesList repository security advisories for a GitHub repository.5 params

List repository security advisories for a GitHub repository.

Parameters* required

directionstring

Sort direction.one of asc · desc

ownerstring

The owner of the repository.

repostring

The name of the repository.

sortstring

Sort field.one of created · updated · published

statestring

Filter by advisory state.one of triage · draft · published · closed

list_secret_scanning_alertsList secret scanning alerts in a GitHub repository.5 params

List secret scanning alerts in a GitHub repository.

Parameters* required

ownerstring

The owner of the repository.

repostring

The name of the repository.

resolutionstring

Filter by resolutionone of false_positive · wont_fix · revoked · pattern_edited · pattern_deleted · used_in_tests

secret_typestring

A comma-separated list of secret types to return. All default secret patterns are returned. To return generic patterns, pass the token name(s) in the parameter.

statestring

Filter by stateone of open · resolved

list_starred_repositoriesList starred repositories5 params

List starred repositories

Parameters* required

directionstring

The direction to sort the results by.one of asc · desc

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

sortstring

How to sort the results. Can be either 'created' (when the repository was starred) or 'updated' (when the repository was last pushed to).one of created · updated

usernamestring

Username to list starred repositories for. Defaults to the authenticated user.

list_tagsList git tags in a GitHub repository4 params

List git tags in a GitHub repository

Parameters* required

ownerstring

Repository owner

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

repostring

Repository name

manage_notification_subscriptionManage a notification subscription: ignore, watch, or delete a notification thread subscription.2 params

Manage a notification subscription: ignore, watch, or delete a notification thread subscription.

Parameters* required

actionstring

Action to perform: ignore, watch, or delete the notification subscription.one of ignore · watch · delete

notificationIDstring

The ID of the notification thread.

manage_repository_notification_subscriptionManage a repository notification subscription: ignore, watch, or delete repository notifications subscription for the provided repository.3 params

Manage a repository notification subscription: ignore, watch, or delete repository notifications subscription for the provided repository.

Parameters* required

actionstring

Action to perform: ignore, watch, or delete the repository notification subscription.one of ignore · watch · delete

ownerstring

The account owner of the repository.

repostring

The name of the repository.

mark_all_notifications_readMark all notifications as read3 params

Mark all notifications as read

Parameters* required

lastReadAtstring

Describes the last point that notifications were checked (optional). Default: Now

ownerstring

Optional repository owner. If provided with repo, only notifications for this repository are marked as read.

repostring

Optional repository name. If provided with owner, only notifications for this repository are marked as read.

merge_pull_requestMerge a pull request in a GitHub repository.6 params

Merge a pull request in a GitHub repository.

Parameters* required

commit_messagestring

Extra detail for merge commit

commit_titlestring

Title for merge commit

merge_methodstring

Merge methodone of merge · squash · rebase

ownerstring

Repository owner

pullNumbernumber

Pull request number

repostring

Repository name

projects_getGet details about specific GitHub Projects resources. Use this tool to get details about individual projects, project fields, and project items by their unique IDs.8 params

Get details about specific GitHub Projects resources. Use this tool to get details about individual projects, project fields, and project items by their unique IDs.

Parameters* required

field_idnumber

The field's ID. Required for 'get_project_field' method.

fieldsarray

Specific list of field IDs to include in the response when getting a project item (e.g. ["102589", "985201", "169875"]). If not provided, only the title field is included. Only used for 'get_projec...

item_idnumber

The item's ID. Required for 'get_project_item' method.

methodstring

The method to executeone of get_project · get_project_field · get_project_item · get_project_status_update

ownerstring

The owner (user or organization login). The name is not case sensitive.

owner_typestring

Owner type (user or org). If not provided, will be automatically detected.one of user · org

project_numbernumber

The project's number.

status_update_idstring

The node ID of the project status update. Required for 'get_project_status_update' method.

projects_listTools for listing GitHub Projects resources. Use this tool to list projects for a user or organization, or list project fields and items for a specific project.9 params

Tools for listing GitHub Projects resources. Use this tool to list projects for a user or organization, or list project fields and items for a specific project.

Parameters* required

afterstring

Forward pagination cursor from previous pageInfo.nextCursor.

beforestring

Backward pagination cursor from previous pageInfo.prevCursor (rare).

fieldsarray

Field IDs to include when listing project items (e.g. ["102589", "985201"]). CRITICAL: Always provide to get field values. Without this, only titles returned. Only used for 'list_project_items' met...

methodstring

The action to performone of list_projects · list_project_fields · list_project_items · list_project_status_updates

ownerstring

The owner (user or organization login). The name is not case sensitive.

owner_typestring

Owner type (user or org). If not provided, will automatically try both.one of user · org

per_pagenumber

Results per page (max 50)

project_numbernumber

The project's number. Required for 'list_project_fields', 'list_project_items', and 'list_project_status_updates' methods.

querystring

Filter/query string. For list_projects: filter by title text and state (e.g. "roadmap is:open"). For list_project_items: advanced filtering using GitHub's project filtering syntax.

projects_writeAdd, update, or delete project items, or create status updates in a GitHub Project.15 params

Add, update, or delete project items, or create status updates in a GitHub Project.

Parameters* required

bodystring

The body of the status update (markdown). Used for 'create_project_status_update' method.

issue_numbernumber

The issue number (use when item_type is 'issue' for 'add_project_item' method). Provide either issue_number or pull_request_number.

item_idnumber

The project item ID. Required for 'update_project_item' and 'delete_project_item' methods.

item_ownerstring

The owner (user or organization) of the repository containing the issue or pull request. Required for 'add_project_item' method.

item_repostring

The name of the repository containing the issue or pull request. Required for 'add_project_item' method.

item_typestring

The item's type, either issue or pull_request. Required for 'add_project_item' method.one of issue · pull_request

methodstring

The method to executeone of add_project_item · update_project_item · delete_project_item · create_project_status_update

ownerstring

The project owner (user or organization login). The name is not case sensitive.

owner_typestring

Owner type (user or org). If not provided, will be automatically detected.one of user · org

project_numbernumber

The project's number.

pull_request_numbernumber

The pull request number (use when item_type is 'pull_request' for 'add_project_item' method). Provide either issue_number or pull_request_number.

start_datestring

The start date of the status update in YYYY-MM-DD format. Used for 'create_project_status_update' method.

statusstring

The status of the project. Used for 'create_project_status_update' method.one of INACTIVE · ON_TRACK · AT_RISK · OFF_TRACK · COMPLETE

target_datestring

The target date of the status update in YYYY-MM-DD format. Used for 'create_project_status_update' method.

updated_fieldobject

Object consisting of the ID of the project field to update and the new value for the field. To clear the field, set value to null. Example: {"id": 123456, "value": "New Value"}. Required for 'updat...

pull_request_readGet information on a specific pull request in GitHub repository.6 params

Get information on a specific pull request in GitHub repository.

Parameters* required

methodstring

Action to specify what pull request data needs to be retrieved from GitHub. Possible options: 1. get - Get details of a specific pull request. 2. get_diff - Get the diff of a pull request. 3....one of get · get_diff · get_status · get_files · get_review_comments · get_reviews

ownerstring

Repository owner

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

pullNumbernumber

Pull request number

repostring

Repository name

pull_request_review_writeCreate and/or submit, delete review of a pull request. Available methods: - create: Create a new review of a pull request. If "event" parameter is provided, the review is submitted. If "event" is omitted, a pending review is created. - submit_pending: Submit an existing pendin...7 params

Create and/or submit, delete review of a pull request. Available methods: - create: Create a new review of a pull request. If "event" parameter is provided, the review is submitted. If "event" is omitted, a pending review is created. - submit_pending: Submit an existing pendin...

Parameters* required

bodystring

Review comment text

commitIDstring

SHA of commit to review

eventstring

Review action to perform.one of APPROVE · REQUEST_CHANGES · COMMENT

methodstring

The write operation to perform on pull request review.one of create · submit_pending · delete_pending

ownerstring

Repository owner

pullNumbernumber

Pull request number

repostring

Repository name

push_filesPush multiple files to a GitHub repository in a single commit5 params

Push multiple files to a GitHub repository in a single commit

Parameters* required

branchstring

Branch to push to

filesarray

Array of file objects to push, each object with path (string) and content (string)

messagestring

Commit message

ownerstring

Repository owner

repostring

Repository name

request_copilot_reviewRequest a GitHub Copilot code review for a pull request. Use this for automated feedback on pull requests, usually before requesting a human reviewer.3 params

Request a GitHub Copilot code review for a pull request. Use this for automated feedback on pull requests, usually before requesting a human reviewer.

Parameters* required

ownerstring

Repository owner

pullNumbernumber

Pull request number

repostring

Repository name

run_secret_scanningScan files, content, or recent changes for secrets such as API keys, passwords, tokens, and credentials. This tool is intended for targeted scans of specific files, snippets, or diffs provided directly as content. It accepts file contents or diffs and returns detected secrets...3 params

Scan files, content, or recent changes for secrets such as API keys, passwords, tokens, and credentials. This tool is intended for targeted scans of specific files, snippets, or diffs provided directly as content. It accepts file contents or diffs and returns detected secrets...

Parameters* required

filesarray

Array of file contents, snippets, or diff hunks to scan for secrets. These must be raw contents, not repository file paths.

ownerstring

Repository owner

repostring

Repository name

search_codeFast and precise code search across ALL GitHub repositories using GitHub's native search engine. Best for finding exact symbols, functions, classes, or specific code patterns.5 params

Fast and precise code search across ALL GitHub repositories using GitHub's native search engine. Best for finding exact symbols, functions, classes, or specific code patterns.

Parameters* required

orderstring

Sort order for resultsone of asc · desc

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

querystring

Search query using GitHub's powerful code search syntax. Examples: 'content:Skill language:Java org:github', 'NOT is:archived language:Python OR language:go', 'repo:github/github-mcp-server'. Suppo...

sortstring

Sort field ('indexed' only)

search_issuesSearch for issues in GitHub repositories using issues search syntax already scoped to is:issue7 params

Search for issues in GitHub repositories using issues search syntax already scoped to is:issue

Parameters* required

orderstring

Sort orderone of asc · desc

ownerstring

Optional repository owner. If provided with repo, only issues for this repository are listed.

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

querystring

Search query using GitHub issues search syntax

repostring

Optional repository name. If provided with owner, only issues for this repository are listed.

sortstring

Sort field by number of matches of categories, defaults to best matchone of comments · reactions · reactions-+1 · reactions--1 · reactions-smile · reactions-thinking_face

search_orgsFind GitHub organizations by name, location, or other organization metadata. Ideal for discovering companies, open source foundations, or teams.5 params

Find GitHub organizations by name, location, or other organization metadata. Ideal for discovering companies, open source foundations, or teams.

Parameters* required

orderstring

Sort orderone of asc · desc

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

querystring

Organization search query. Examples: 'microsoft', 'location:california', 'created:>=2025-01-01'. Search is automatically scoped to type:org.

sortstring

Sort field by categoryone of followers · repositories · joined

search_pull_requestsSearch for pull requests in GitHub repositories using issues search syntax already scoped to is:pr7 params

Search for pull requests in GitHub repositories using issues search syntax already scoped to is:pr

Parameters* required

orderstring

Sort orderone of asc · desc

ownerstring

Optional repository owner. If provided with repo, only pull requests for this repository are listed.

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

querystring

Search query using GitHub pull request search syntax

repostring

Optional repository name. If provided with owner, only pull requests for this repository are listed.

sortstring

Sort field by number of matches of categories, defaults to best matchone of comments · reactions · reactions-+1 · reactions--1 · reactions-smile · reactions-thinking_face

search_repositoriesFind GitHub repositories by name, description, readme, topics, or other metadata. Perfect for discovering projects, finding examples, or locating specific repositories across GitHub.6 params

Find GitHub repositories by name, description, readme, topics, or other metadata. Perfect for discovering projects, finding examples, or locating specific repositories across GitHub.

Parameters* required

minimal_outputboolean

Return minimal repository information (default: true). When false, returns full GitHub API repository objects.default: true

orderstring

Sort orderone of asc · desc

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

querystring

Repository search query. Examples: 'machine learning in:name stars:>1000 language:python', 'topic:react', 'user:facebook'. Supports advanced search syntax for precise filtering.

sortstring

Sort repositories by field, defaults to best matchone of stars · forks · help-wanted-issues · updated

search_usersFind GitHub users by username, real name, or other profile information. Useful for locating developers, contributors, or team members.5 params

Find GitHub users by username, real name, or other profile information. Useful for locating developers, contributors, or team members.

Parameters* required

orderstring

Sort orderone of asc · desc

pagenumber

Page number for pagination (min 1)

perPagenumber

Results per page for pagination (min 1, max 100)

querystring

User search query. Examples: 'john smith', 'location:seattle', 'followers:>100'. Search is automatically scoped to type:user.

sortstring

Sort users by number of followers or repositories, or when the person joined GitHub.one of followers · repositories · joined

star_repositoryStar a GitHub repository2 params

Star a GitHub repository

Parameters* required

ownerstring

Repository owner

repostring

Repository name

Readme

GitHub MCP Server

The GitHub MCP Server connects AI tools directly to GitHub's platform. This gives AI agents, assistants, and chatbots the ability to read repositories and code files, manage issues and PRs, analyze code, and automate workflows. All through natural language interactions.

Use Cases

View the full README on GitHub

Details

Repository: github.com/github/github-mcp-server
Category: Developer Tools
Package: ghcr.io/github/github-mcp-server:2.1.0
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active

Related Developer Tools MCP servers

View all

Repomixyamadashy/repomixPack local or remote codebases into AI-friendly files that LLMs and coding agents can read or search29.2Kstars

GitLab MCP Serverzereight/gitlab-mcpGitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more.2.1Kstars

Sentrygetsentry/toolkitMCP server for Sentry - error monitoring, issue tracking, and debugging for AI assistants0stars

Filesystemmark3labs/mcp-filesystem-serverGo server implementing Model Context Protocol (MCP) for filesystem operations.640stars

Linearjerhadf/linear-mcp-serverA server that integrates Linear's project management system with the Model Context Protocol (MCP) to allow LLMs to interact with Linear.344stars

Mcpsnyk/studio-mcpEasily find and fix security issues in your applications leveraging Snyk platform capabilities.0stars