The GitHub MCP Server is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that provides seamless integration
Github github mcp server connects Github Github to AI assistants that speak the Model Context Protocol. The GitHub MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with GitHub APIs, enabling advanced automation and interaction capabilities for developers and tools.
The GitHub MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with GitHub APIs, enabling advanced automation and interaction capabilities for developers and tools.
Once connected, the assistant can call these 14 tools directly:
Toolset — Descriptionactions — GitHub Actions workflows and CI/CD operationscontext — Strongly recommended: Tools that provide context about the current user and GitHub context you are operating incode_security — Code scanning alerts and security featuresissues — Issue-related tools (create, read, update, comment)notifications — GitHub Notifications related toolspull_requests — Pull request operations (create, merge, review)repos — Repository-related tools (file operations, branches, commits)secret_protection — Secret protection related tools, such as GitHub Secret Scanningusers — Anything relating to GitHub Usersexperiments — Experimental features (not considered stable)Configuration — See Remote Server Documentation on how to pass additional configuration settings to the remote GitHub MCP ServerUsers — The Users tool exposed by this serverIssues — The Issues tool exposed by this serverSetup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.
Before the server will start you need to supply 5 environment variables: GITHUB_PERSONAL_ACCESS_TOKEN, GITHUB_HOST, TOOL_ADD_ISSUE_COMMENT_DESCRIPTION, TOOL_CREATE_BRANCH_DESCRIPTION, YOUR_TOKEN. Keep credentials in your client's env block or a secrets manager rather than committing them.
Developer-tool servers are usually the first ones people connect, because they turn "help me with this code" into an assistant that can actually read the repo and act on it. Github Github sits in that group, and the shape of its toolset — Toolset, actions, context among others — tells you what it is really for. Worth comparing against the other developer tools servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.
| Tool | What it does |
|---|---|
| Toolset | Description |
| actions | GitHub Actions workflows and CI/CD operations |
| context | **Strongly recommended**: Tools that provide context about the current user and GitHub context you are operating in |
| code_security | Code scanning alerts and security features |
| issues | Issue-related tools (create, read, update, comment) |
| notifications | GitHub Notifications related tools |
| pull_requests | Pull request operations (create, merge, review) |
| repos | Repository-related tools (file operations, branches, commits) |
| secret_protection | Secret protection related tools, such as GitHub Secret Scanning |
| users | Anything relating to GitHub Users |
| experiments | Experimental features (not considered stable) |
| Configuration | See [Remote Server Documentation](docs/remote-server.md) on how to pass additional configuration settings to the remote GitHub MCP Server. |
| Users | The Users tool exposed by this server. |
| Issues | The Issues tool exposed by this server. |
{
"mcpServers": {
"github": {
"url": "https://api.githubcopilot.com/mcp/"
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| GITHUB_PERSONAL_ACCESS_TOKEN | Credential the server authenticates with. | Yes |
| GITHUB_HOST | Endpoint or connection string the server talks to. | Optional |
| TOOL_ADD_ISSUE_COMMENT_DESCRIPTION | Configuration value read at startup. | Optional |
| TOOL_CREATE_BRANCH_DESCRIPTION | Configuration value read at startup. | Optional |
| YOUR_TOKEN | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.