GitHub Official
Official GitHub integration with comprehensive API coverage
What is GitHub Official?
GitHub Official is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to official github mcp server provides complete github api integration for repository management, issue tracking, pull requests, and code operations. built and maintained by github.
The official GitHub MCP server provides complete GitHub API integration for repository management, issue tracking, pull requests, and code operations. Built and maintained by GitHub.
This server falls under the Version Control category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Repository management and file operations
- Issue and PR management
- Code security scanning
- Dynamic toolset discovery
- Search across repositories
- Branch and commit operations
Use Cases
Maintainer
Works with
Installation
Manual Installation
docker pull ghcr.io/github/github-mcp-serverDocker
docker run -i --rm ghcr.io/github/github-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Security
Authentication
Performance
Response Metrics
Resource Usage
How to Set Up and Use GitHub Official
The GitHub Official MCP server is GitHub's own integration layer that exposes over 100 tools covering repositories, issues, pull requests, GitHub Actions, code security scanning, and team collaboration through the Model Context Protocol. It is distributed as a Docker image and connects to GitHub's API using a personal access token, allowing AI assistants to read and write repository content, open and update PRs, monitor CI/CD pipeline status, and query code scanning alerts — all from natural language. Because it is maintained by GitHub itself, it stays in sync with the latest API features including GitHub Enterprise Server support and dynamic toolset discovery.
Prerequisites
- Docker installed and running (the server is distributed as a container image)
- A GitHub Personal Access Token with appropriate scopes (at minimum: repo, read:org)
- An MCP-compatible client such as Claude Desktop
- For GitHub Enterprise: the hostname of your GHES instance
Pull the official Docker image
Download the pre-built image from GitHub's container registry. No build step is required — GitHub publishes new releases automatically.
docker pull ghcr.io/github/github-mcp-serverCreate a GitHub Personal Access Token
Go to GitHub Settings → Developer settings → Personal access tokens. Create a token with the scopes your workflow needs: repo (full control), read:packages, and read:org for organization access. Copy the token value.
Test the server manually
Run the container interactively to confirm it connects to GitHub successfully. The server expects GITHUB_PERSONAL_ACCESS_TOKEN and communicates via stdio.
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
ghcr.io/github/github-mcp-serverAdd the server to your MCP client configuration
Open your claude_desktop_config.json and configure the GitHub MCP server. Pass your token through the env block — never hardcode tokens directly into config files checked into version control.
Restrict tools to only what you need (optional)
By default all toolsets are enabled. Set GITHUB_TOOLSETS to a comma-separated list to limit scope. Available toolsets include: repos, issues, pull_requests, actions, code_security, and experiments.
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
-e GITHUB_TOOLSETS="repos,issues,pull_requests" \
ghcr.io/github/github-mcp-serverEnable read-only mode for safer access
If you only need read access to repositories, set GITHUB_READ_ONLY=1 to prevent any write operations.
GitHub Official Examples
Client configuration
Add the GitHub MCP server to claude_desktop_config.json. Store your token in an environment variable and reference it to avoid exposing secrets.
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat-here"
}
}
}
}Prompts to try
Example prompts that leverage the 100+ GitHub API tools available through this server.
- "List all open pull requests in owner/repo that have been waiting for review more than 3 days"
- "Create a GitHub issue in my-org/my-repo titled 'Fix login bug' with labels bug and high-priority"
- "Show me the latest GitHub Actions workflow run for the main branch and explain any failures"
- "Search for all files in owner/repo containing the string 'deprecated_function'"
- "Get the code scanning alerts for owner/repo and summarize the critical severity findings"Troubleshooting GitHub Official
Docker run fails with 'permission denied' or cannot connect to the Docker daemon
Ensure your user is in the docker group (Linux: sudo usermod -aG docker $USER) or that Docker Desktop is running (macOS/Windows). On Linux you may need to log out and back in after adding yourself to the group.
API calls return 401 Unauthorized or 403 Forbidden errors
Verify that GITHUB_PERSONAL_ACCESS_TOKEN is set correctly in the env block and that the token has not expired. Check that the token has the repo scope for private repository access and read:org for organization data.
The server shows no tools or only a partial tool list
If GITHUB_TOOLSETS is set, ensure it includes the toolsets you need. Remove the GITHUB_TOOLSETS env variable to load all default tools, or explicitly add the required toolset names (repos, issues, pull_requests, actions, code_security).
Frequently Asked Questions about GitHub Official
What is GitHub Official?
GitHub Official is a Model Context Protocol (MCP) server that official github integration with comprehensive api coverage It connects AI assistants to external tools and data sources through a standardized interface.
How do I install GitHub Official?
Follow the installation instructions on the GitHub Official GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with GitHub Official?
GitHub Official works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is GitHub Official free to use?
Yes, GitHub Official is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
GitHub Official Alternatives — Similar Version Control Servers
Looking for alternatives to GitHub Official? Here are other popular version control servers you can use with Claude, Cursor, and VS Code.
Ruiyu MA
★ 30.1kConnect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
GitMCP
★ 8.1kTransforms any GitHub repository or GitHub Pages site into a documentation hub for AI assistants using the Model Context Protocol. It allows AI tools to access real-time code and documentation to prevent hallucinations and provide accurate API usage
GitHub Codemunch
★ 1.8kA token-efficient MCP server for exploring GitHub repositories using tree-sitter AST parsing to extract symbol signatures and summaries. It enables users to search and retrieve specific code components while significantly reducing token consumption c
Azure DevOps MCP Server
★ 1.7kThis server provides a convenient API for interacting with Azure DevOps services, enabling AI assistants and other tools to manage work items, code repositories, boards, sprints, and more. Built with the Model Context Protocol, it provides a standard
Azure DevOps
★ 367Enables interaction with Azure DevOps through Cursor chat, providing tools to manage builds, pipelines, work items, sprints, and board operations. Supports secure authentication via Personal Access Tokens and allows natural language-driven DevOps tas
MCP Git Ingest
★ 306Helps AI read GitHub repository structure and important files. Want to quickly understand what a repo is about? Prompt it with 'read https://github.com/adhikasp/mcp-git-ingest and determine how the code technically works'.
Browse More Version Control MCP Servers
Explore all version control servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up GitHub Official in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use GitHub Official?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.