GitHub MCP: Documentation
Updated:
Connection
- Remote:
https://api.githubcopilot.com/mcp/(OAuth, needs VS Code 1.101+ for browser login). - Local: docker image
ghcr.io/github/github-mcp-serverwith aGITHUB_PERSONAL_ACCESS_TOKEN. GITHUB_HOST— set for GitHub Enterprise/ghe.com instead of github.com.GITHUB_TOOLSETS— comma-separated list of toolsets to enable;--dynamic-toolsetslets the host enable toolsets mid-conversation.--read-onlyflag — read access only, strictly disables write tools.
Toolsets and tools
repos(default):get_file_contents,create_or_update_file,push_files,create_branch,list_commits,search_code,search_repositories,get_latest_release, etc.issues(default):issue_read,issue_write,list_issues,search_issues,add_issue_comment,list_issue_types.pull_requests(default):create_pull_request,pull_request_read,pull_request_review_write,merge_pull_request,update_pull_request.context(default):get_me,get_teams,get_team_members.actions:actions_list,actions_get,actions_run_trigger,get_job_logs.- Opt-in toolsets:
code_security,dependabot,discussions,gists,git,labels,notifications,orgs,projects,secret_protection,security_advisories,stargazers.
Agent flow
"File an issue for this bug", "show failed jobs of the last CI run", "open a PR with this fix".
Limits
Free to use; standard GitHub REST API limits apply (typically 5,000 requests/hour per authenticated token).