696
GitHub Pro MCP gives Claude Code, Cursor, Copilot, opencode and any MCP host a complete GitHub toolkit: 34 tools for issues, pull requests, files, projects, labels and organizations.
Read-only mode is the default. The server registers 19 read tools and keeps the
15 write tools out of the agent's context. Set
GITHUB_MCP_ENABLE_WRITES=true to load the full set.
It runs locally, connects to your host over stdio, and calls the GitHub API directly with your own token. There is no intermediary service.
New to MCP? It is the open protocol that lets a host connect a model to tools: https://modelcontextprotocol.io/
Documentation, installation guides, permissions and token generator: https://mcp.anantanandgupta.net/
Ask in plain language. The agent chooses the tools, and the server handles the API details.
owner_list_repository lists every repository in an
organization.GITHUB_OWNER / GITHUB_REPO, and mismatched calls are rejected.GITHUB_HOST at your GHES API.If your work is mostly Actions, security scanning, notifications, discussions, gists, governance or Copilot, use the official GitHub MCP server. GitHub Pro MCP is built for the daily issue, pull request, file and project loop.
Requires Node.js 22 or newer for the npm package. The Docker image includes Node.js.
# Install globally
npm install -g github-pro-mcp
# Or run directly without installing
npx -y github-pro-mcp
Multi-arch images are published for linux/amd64 and linux/arm64.
docker pull anantanandgupta/github-pro-mcp
auth_get_current_login tool.By default the server is read-only and registers 19 tools. To enable issue,
pull request, file, label and project writes, set
GITHUB_MCP_ENABLE_WRITES=true in the host environment.
Use a fine-grained personal access token. The generator builds a pre-filled GitHub page with the right checkboxes:
Merging a pull request also requires Contents write. If the repository belongs to an organization that requires approval, request it while creating the token.
The full per-tool permission table is at https://mcp.anantanandgupta.net/github-pro-mcp/permissions/
The read-only preset pairs with the default read-only mode. The read-write
preset requires GITHUB_MCP_ENABLE_WRITES=true in the host environment.
Add to your opencode config (v2 nests servers under mcp.servers):
{
"mcp": {
"servers": {
"github_pro": {
"type": "local",
"command": ["npx", "-y", "github-pro-mcp"],
"environment": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "{env:GITHUB_TOKEN}",
"GITHUB_MCP_ENABLE_WRITES": "true"
}
}
}
}
}
{env:GITHUB_TOKEN} reads that variable from the environment opencode starts
in. Use a literal token instead if you prefer. Remove
GITHUB_MCP_ENABLE_WRITES to stay read-only.
Edit claude_desktop_config.json and restart Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "github-pro-mcp"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_...",
"GITHUB_MCP_ENABLE_WRITES": "true"
}
}
}
}
Both support stdio MCP servers. The configuration is the same command and token as above; only the file location differs. Exact snippets are in the installation guide:
https://mcp.anantanandgupta.net/github-pro-mcp/install/
{
"mcp": {
"servers": {
"github_pro": {
"type": "local",
"command": ["docker", "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "-e", "GITHUB_MCP_ENABLE_WRITES", "anantanandgupta/github-pro-mcp"],
"environment": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "{env:GITHUB_TOKEN}",
"GITHUB_MCP_ENABLE_WRITES": "true"
}
}
}
}
}
The same docker run command works as the server command in other hosts.
| Variable | Description |
|---|---|
GITHUB_PERSONAL_ACCESS_TOKEN | GitHub personal access token. Fine-grained is recommended. |
| Variable | Description |
|---|---|
GITHUB_HOST | GitHub Enterprise Server API, for example https://github.example.com/api/v3 |
GITHUB_OWNER | Pin the server to a single owner and reject mismatched calls |
GITHUB_REPO | Pin the server to a single repository and reject mismatched calls |
GITHUB_MCP_ENABLE_WRITES | Set to true, 1, yes or on to register the 15 write tools. Default false |
Retries, rate limiting and logging have sensible defaults. You do not need to tune them for normal use.
34 tools across 8 domains. Read-only mode registers 19 of them; the other 15 are write tools. Tool names appear in your host's tool list after the server starts.
| Domain | Tools | Count |
|---|---|---|
| User & Repos | auth_get_current_login, file_get_content, profile_get, owner_list_repository, file_create_update, file_delete, code_search, repository_search | 8 |
| Issues | issue_read, issue_list, issue_search, issue_add_comment, sub_issue_write, issue_create, issue_close, issue_reopen, issue_update, issue_add_label, issue_remove_label | 11 |
| Issue Fields | owner_list_issue_field, issue_get_field_value, issue_set_field_value | 3 |
| Pull Requests | pull_request_read, pull_request_create, pull_request_merge | 3 |
| Organizations | organization_search, owner_list_issue_type, owner_list_organization | 3 |
| Projects v2 | owner_list_project, projects_get, projects_write | 3 |
| Labels | label_list, label_write | 2 |
| Server Info | server_info | 1 |
| Total | 34 |
Task-based examples and the prompts they respond to are at https://mcp.anantanandgupta.net/github-pro-mcp/tools/
A measured comparison with the official GitHub MCP server is at https://mcp.anantanandgupta.net/github-pro-mcp/compare/
| Symptom | Likely cause |
|---|---|
401 | Token expired, revoked or mistyped |
403 | Missing permission, organization approval, or SSO not authorized |
404 | The resource does not exist, or the token cannot see it |
429 | Rate limited. The server retries; wait if it persists |
| No tools appear in the host | The host was not restarted, or the server failed to start |
| Server exits immediately | GITHUB_PERSONAL_ACCESS_TOKEN is not set in the host's environment |
| Write tool not in the list | GITHUB_MCP_ENABLE_WRITES is not set to true |
Proprietary. Free to install and use, including for internal business purposes. Modification, redistribution, sublicensing and reverse engineering are not permitted. See the license for the full terms.
Content type
Image
Digest
sha256:056a0b204…
Size
58.7 MB
Last updated
13 days ago
docker pull anantanandgupta/github-pro-mcp