GitHub MCP server
officialGitHub's own MCP server gives an agent access to repositories, issues, pull requests and Actions. It runs as a hosted service or a local Docker image, and can be locked to read-only or to selected toolsets.
What an agent can do
- → Read code and files in repositories
- → Create and comment on issues
- → Review and open pull requests
- → Follow Actions runs, with the actions toolset enabled
- → Read code security alerts, with the code_security toolset enabled
Write tools are on by default, so enable read-only mode or limit toolsets for teams that only need to read. The remote server does not support GitHub Enterprise Server, which needs the local server.
About the GitHub MCP server
The GitHub MCP Server is GitHub's official server, developed as open source under the MIT licence. It comes in two forms: a remote server that GitHub hosts, and a local server you run as a Docker image or your own build. According to GitHub it is available to all GitHub users regardless of plan, and it is built into Copilot CLI and configured by default for Copilot cloud agent and Copilot code review.
Teams use it to let an assistant read code and history, search repositories, create and comment on issues, open and review pull requests and see why an Actions run failed. With more toolsets enabled it also reaches Dependabot, secret scanning, discussions, projects and notifications. The remote server adds toolsets the local one lacks, such as Copilot Spaces and a search of GitHub's support documentation.
The server can never do more than the scopes you approve at OAuth sign-in or the ones your personal access token grants, and organisation policies can narrow that further. Write tools are on from the start, but a read-only mode removes them entirely, and you choose which toolsets exist. A lockdown mode filters content from unknown users in public repositories, though GitHub describes it as a best-effort filter, not a security boundary.
Things to ask
- Which pull requests in our web repository are waiting for my review, and what does each one change?
- Why did last night's Actions run on main fail? Show the step that broke and the error message.
- Create an issue from this bug report, with steps to reproduce and the label bug.
- Summarise what has changed in the payments module since the last release.
- Are there open secret scanning alerts in any of our repositories?
Tools the server exposes
- get_file_contents
- search_code
- search_repositories
- list_commits
- list_branches
- create_branch
- create_or_update_file
- push_files
- create_repository
- fork_repository
- issue_read
- list_pull_requests
- search_pull_requests
- pull_request_read
- create_pull_request
- update_pull_request
- merge_pull_request
- pull_request_review_write
- list_secret_scanning_alerts
- get_secret_scanning_alert
Part of these packages
GitHub is part of these Walma packages.
Questions about GitHub MCP
Is the GitHub MCP Server free?+
GitHub says the server is available to all GitHub users regardless of plan, and the code is open source under the MIT licence. Tools that depend on paid features need the matching subscription: Copilot cloud agent requires a GitHub Copilot subscription, and code scanning requires GitHub Advanced Security.
What is the GitHub MCP server URL?+
The remote server is at https://api.githubcopilot.com/mcp/. Adding /readonly gives you read tools only, and /x/issues gives a single toolset. The local server is the Docker image ghcr.io/github/github-mcp-server, or your own build from the github/github-mcp-server repository.
How does sign-in work?+
OAuth is the default: you sign in to GitHub and the server can only access the scopes you approve. The alternative is a personal access token sent as a Bearer token, which gives the server the scopes that token grants. For Enterprise Managed Users, personal access tokens are disabled by default unless an enterprise administrator enables them.
Is it read-only?+
Not by default. The default toolsets context, repos, issues, pull_requests and users include tools that create files, branches, issues and pull requests. Read-only mode is switched on with the --read-only flag locally, or with the /readonly path or the X-MCP-Readonly header on the remote server. Write tools are then skipped even if they are requested by name.
Which AI assistants does GitHub MCP work with?+
GitHub's README names VS Code from version 1.101, Claude Desktop, Cursor and Windsurf, and GitHub's documentation also covers Visual Studio, JetBrains IDEs, Xcode and Eclipse. The server is built into Copilot CLI. Some hosts only support a personal access token, not OAuth, and the local server works in any MCP-compatible editor.
Does it work with GitHub Enterprise Server?+
Only the local server. The remote server does not support GitHub Enterprise Server. Locally you set your host with --gh-host or GITHUB_HOST, and HTTPS is required. For ghe.com you use https://YOURSUBDOMAIN.ghe.com. OAuth on Enterprise Server and ghe.com requires registering your own OAuth App or GitHub App.
Can an organisation control its use?+
Yes. For users on Copilot Business or Copilot Enterprise the policy MCP servers in Copilot must be enabled, and it is disabled by default. Copilot Free, Pro, Pro+ and Max are not governed by it. The organisation's restrictions on OAuth apps and personal access tokens also apply to the server.
Missing a connection?
We build and review MCP servers for teams that need them, and run them behind the same policy and log as the rest of the gateway.