Work with repositories, issues, pull requests and Actions on GitHub from your agent, through GitHub's own MCP server.
by GitHub· Developer toolsUnclaimed · Yours? Claim it
Once it’s added
“Which pull requests are waiting on my review? Start with the smallest.”
Plugins people install alongside GitHub MCP Server.
4 images
“Find where we call the payments API without retries and open an issue for each.”
“Sum up what shipped in northwind/web this week, by author.”
“Bump Next.js to 16.3 in northwind/site and open a pull request.”
Before you add it
Reads only
Read files and search code · Find issues and pull requests · Read diffs, reviews and checks · See your teams
Makes changes · your agent can ask first
Open and comment on issues · Open, review and merge pull requests · Create branches and push files
Tool by tool
GitHub MCP Server has 96 tools in 24 toolsets. 45 are on by default; the rest wait until you turn on their toolset. We’ve set each one the way we’d run it. Change any, then copy the settings for your agent.
Paste into ~/.claude/settings.json for every project, or .claude/settings.json in one repo. If the file already has permissions, add these to its lists.
{
"permissions": {
"allow": [
"mcp__github__get_me",
"mcp__github__get_team_members",
"mcp__github__get_teams",
"mcp__github__ui_get",
"mcp__github__get_commit",
"mcp__github__get_file_contents",
"mcp__github__get_latest_release",
"mcp__github__get_release_by_tag",
"mcp__github__get_tag",
"mcp__github__list_branches",
"mcp__github__list_commits",
"mcp__github__list_releases",
"mcp__github__list_repository_collaborators",
"mcp__github__list_tags",
"mcp__github__search_code",
"mcp__github__search_commits",
"mcp__github__search_repositories",
"mcp__github__get_label",
"mcp__github__issue_read",
"mcp__github__list_issue_fields",
"mcp__github__list_issue_types",
"mcp__github__list_issues",
"mcp__github__search_issues",
"mcp__github__list_pull_requests",
"mcp__github__pull_request_read",
"mcp__github__search_pull_requests",
"mcp__github__search_users",
"mcp__github__actions_get",
"mcp__github__actions_list",
"mcp__github__get_job_logs",
"mcp__github__get_code_quality_finding",
"mcp__github__get_code_scanning_alert",
"mcp__github__list_code_scanning_alerts",
"mcp__github__get_dependabot_alert",
"mcp__github__list_dependabot_alerts",
"mcp__github__get_discussion",
"mcp__github__get_discussion_comments",
"mcp__github__list_discussion_categories",
"mcp__github__list_discussions",
"mcp__github__get_gist",
"mcp__github__list_gists",
"mcp__github__get_repository_tree",
"mcp__github__custom_properties_read",
"mcp__github__repository_ruleset_read",
"mcp__github__list_label",
"mcp__github__get_notification_details",
"mcp__github__list_notifications",
"mcp__github__search_orgs",
"mcp__github__projects_get",
"mcp__github__projects_list",
"mcp__github__get_secret_scanning_alert",
"mcp__github__list_secret_scanning_alerts",
"mcp__github__get_global_security_advisory",
"mcp__github__list_global_security_advisories",
"mcp__github__list_org_repository_security_advisories",
"mcp__github__list_repository_security_advisories",
"mcp__github__list_starred_repositories",
"mcp__github__get_copilot_space",
"mcp__github__list_copilot_spaces",
"mcp__github__github_support_docs_search"
],
"ask": [
"mcp__github__create_branch",
"mcp__github__create_or_update_file",
"mcp__github__create_repository",
"mcp__github__fork_repository",
"mcp__github__push_files",
"mcp__github__add_issue_comment",
"mcp__github__issue_write",
"mcp__github__sub_issue_write",
"mcp__github__update_issue_comment",
"mcp__github__add_comment_to_pending_review",
"mcp__github__add_reply_to_pull_request_comment",
"mcp__github__create_pull_request",
"mcp__github__merge_pull_request",
"mcp__github__pull_request_review_write",
"mcp__github__update_pull_request",
"mcp__github__update_pull_request_branch",
"mcp__github__actions_run_trigger",
"mcp__github__assign_copilot_to_issue",
"mcp__github__request_copilot_review",
"mcp__github__create_pull_request_with_copilot",
"mcp__github__assign_copilot_to_issue_with_intent",
"mcp__github__discussion_comment_write",
"mcp__github__create_gist",
"mcp__github__update_gist",
"mcp__github__create_repository_ruleset",
"mcp__github__custom_properties_write",
"mcp__github__label_write",
"mcp__github__dismiss_notification",
"mcp__github__manage_notification_subscription",
"mcp__github__manage_repository_notification_subscription",
"mcp__github__mark_all_notifications_read",
"mcp__github__projects_write",
"mcp__github__star_repository",
"mcp__github__unstar_repository"
],
"deny": [
"mcp__github__delete_file",
"mcp__github__delete_repository"
]
}
}No writes at all? Connect to https://api.githubcopilot.com/mcp/readonly instead, or run the local server with --read-only. GitHub MCP Server then leaves out every tool that changes something, whatever your agent allows.
get_meGet my user profileget_team_membersGet team membersget_teamsGet teamsui_getGet UI datacreate_branchCreate branchcreate_or_update_fileCreate or update filecreate_repositoryCreate repositorydelete_fileDelete filedelete_repositoryDelete repositoryfork_repositoryFork repositoryget_commitGet commit detailsget_file_contentsGet file or directory contentsget_latest_releaseGet latest releaseget_release_by_tagGet a release by tag nameget_tagGet tag detailslist_branchesList brancheslist_commitsList commitslist_releasesList releaseslist_repository_collaboratorsList repository collaboratorslist_tagsList tagspush_filesPush files to repositorysearch_codeSearch codesearch_commitsSearch commitssearch_repositoriesSearch repositoriesadd_issue_commentAdd comment to issue or pull requestget_labelGet a specific label from a repositoryissue_readGet issue detailsissue_writeCreate or update issue/pull requestcreate · updatelist_issue_fieldsList issue fieldslist_issue_typesList available issue typeslist_issuesList issuessearch_issuesSearch issuessub_issue_writeChange sub-issueupdate_issue_commentUpdate issue commentadd_comment_to_pending_reviewAdd review comment to the requester's latest pending pull request reviewadd_reply_to_pull_request_commentAdd reply to pull request commentcreate_pull_requestOpen new pull requestlist_pull_requestsList pull requestsmerge_pull_requestMerge pull requestpull_request_readGet details for a single pull requestpull_request_review_writeWrite operations (create, submit, delete) on pull request reviewscreate · submit_pending · delete_pending · resolve_thread · unresolve_threadsearch_pull_requestsSearch pull requestsupdate_pull_requestEdit pull requestupdate_pull_request_branchUpdate pull request branchsearch_usersSearch usersactions_getGet details of GitHub Actions resources (workflows, workflow runs, jobs, and artifacts)actions_listList GitHub Actions workflows in a repositoryactions_run_triggerTrigger GitHub Actions workflow actionsrun_workflow · rerun_workflow_run · rerun_failed_jobs · cancel_workflow_run · delete_workflow_run_logsget_job_logsGet GitHub Actions workflow job logsget_code_quality_findingGet code quality findingget_code_scanning_alertGet code scanning alertlist_code_scanning_alertsList code scanning alertsassign_copilot_to_issueAssign Copilot to issuerequest_copilot_reviewRequest Copilot reviewcreate_pull_request_with_copilotHosted server onlyPerform task with GitHub Copilot coding agentassign_copilot_to_issue_with_intentAssign Copilot to issue with intentget_dependabot_alertGet dependabot alertlist_dependabot_alertsList dependabot alertsdiscussion_comment_writeManage discussion commentsadd · reply · update · delete · mark_answer · unmark_answerget_discussionGet discussionget_discussion_commentsGet discussion commentslist_discussion_categoriesList discussion categorieslist_discussionsList discussionscreate_gistCreate Gistget_gistGet Gist Contentlist_gistsList Gistsupdate_gistUpdate Gistget_repository_treeGet repository treecreate_repository_rulesetCreate repository rulesetcustom_properties_readRead custom propertiescustom_properties_writeSet custom propertiesrepository_ruleset_readRead repository rulesetslabel_writeWrite operations on repository labelscreate · update · deletelist_labelList labels from a repositorydismiss_notificationDismiss notificationget_notification_detailsGet notification detailslist_notificationsList notificationsmanage_notification_subscriptionManage notification subscriptionmanage_repository_notification_subscriptionManage repository notification subscriptionmark_all_notifications_readMark all notifications as readsearch_orgsSearch organizationsprojects_getGet details of GitHub Projects resourcesprojects_listList GitHub Projects resourcesprojects_writeManage GitHub Projectsadd_project_item · update_project_item · update_project_items · delete_project_item · create_project_status_update · create_project_view · update_project_view · delete_project_view · create_project · create_iteration_fieldget_secret_scanning_alertGet secret scanning alertlist_secret_scanning_alertsList secret scanning alertsget_global_security_advisoryGet a global security advisorylist_global_security_advisoriesList global security advisorieslist_org_repository_security_advisoriesList org repository security advisorieslist_repository_security_advisoriesList repository security advisorieslist_starred_repositoriesList starred repositoriesstar_repositoryStar repositoryunstar_repositoryUnstar repositoryget_copilot_spaceHosted server onlyGet Copilot Spacelist_copilot_spacesHosted server onlyList Copilot Spacesgithub_support_docs_searchHosted server onlyRetrieve 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, Copilot SpacesFrom github/github-mcp-server (README.md and pkg/github/__toolsnaps__, c59e8c1, 2026-10-13). Types are the server’s own read-only and destructive flags; a dashed one is read from the tool’s name because its flags aren’t published.
From people who use it
Step by step
Nothing new reaches your agent until a person has looked at it.
Scanned on every change, and again when our rules improve.
A hosted server: nothing runs on your machine.
A hosted server: nothing runs on your machine.
A hosted server: nothing runs on your machine.
A hosted server: nothing runs on your machine.
A hosted server: nothing runs on your machine.
A hosted server: nothing runs on your machine.
A hosted server: nothing runs on your machine.
Add to VS Codecopilot mcp add --transport http github-mcp-server https://api.githubcopilot.com/mcp/
A hosted server: nothing runs on your machine.
Add to Cursor.cursor/mcp.json{
"mcpServers": {
"github-mcp-server": {
"url": "https://api.githubcopilot.com/mcp/"
}
}
}A hosted server: nothing runs on your machine.
claude mcp add --transport http github-mcp-server https://api.githubcopilot.com/mcp/
A hosted server: nothing runs on your machine.
codex mcp add github-mcp-server --url https://api.githubcopilot.com/mcp/
A hosted server: nothing runs on your machine.
~/.gemini/config/mcp_config.json{
"mcpServers": {
"github-mcp-server": {
"url": "https://api.githubcopilot.com/mcp/"
}
}
}Runs on your machine.
gemini extensions install https://github.com/github/github-mcp-server
A hosted server: nothing runs on your machine.
A hosted server: nothing runs on your machine.
openclaw mcp add github-mcp-server --url https://api.githubcopilot.com/mcp/ --transport streamable-http
A hosted server: nothing runs on your machine.
opencode mcp add github-mcp-server --url https://api.githubcopilot.com/mcp/
A hosted server: nothing runs on your machine.
hermes mcp add github-mcp-server --url https://api.githubcopilot.com/mcp/
~/.hermes/config.yaml{
"mcp_servers": {
"github-mcp-server": {
"url": "https://api.githubcopilot.com/mcp/"
}
}
}AuthorizationOptionalSecretAuthorization header with authentication token (PAT or App token)Scanned and passed · checked 7 h ago
No reviews yet. Used GitHub MCP Server? Say how it went.
Write a reviewPlugins people install alongside GitHub MCP Server.
Matt Pocock's everyday engineering skills: grilling sessions, specs and tickets, TDD, bug diagnosis, code review and writing for agents.
Addy Osmani's engineering workflows for coding agents: spec, plan, build, test, review and ship, with quality gates at each step.
Nobody has shared how they use GitHub MCP Server yet.
Security scan
Passed
Safe to install in every agent it supports. Runs remotely on api.githubcopilot.com · needs your sign-in.