Connect GitHub MCP to Claude Code
GitHub's official MCP server. Agents can read code, issues and pull requests, open PRs and leave reviews, so a design change can go from canvas to merged code.
MCP serverOfficialChecked 2026-11-16
Before you start
- Claude Code installed (see its MCP documentation (opens in a new tab)).
- GitHub MCP is available on macOS, Windows and Linux.
- This setup runs GitHub's Docker image, so Docker must be installed and running. Create a fine-grained personal access token with only the repositories and permissions you need, and set it as
GITHUB_PERSONAL_ACCESS_TOKENin your environment. To skip Docker, use GitHub MCP (remote), the hosted version.
Step 1: Add GitHub MCP to Claude Code
Add it from the terminal
Run this in your project folder. It saves the server for you, in this project only.
Terminal claude mcp add github -e 'GITHUB_PERSONAL_ACCESS_TOKEN=${GITHUB_PERSONAL_ACCESS_TOKEN}' -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-serverOr share it with your team
Add this to
.mcp.jsonat the project root and commit it. Teammates approve it the first time Claude Code starts..mcp.json { "mcpServers": { "github": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}" } } } }Good to know- Claude Code reads the
${NAME}values from your environment when the server starts.
- Claude Code reads the
Step 2: Check it's connected
Terminal claude mcp listStart a session and run
/mcpto see the server, its status and its tools.Step 3: Try a first request
Ask Claude Code something that only works with GitHub MCP connected:
Say to Claude Code List the open pull requests in this repository and summarise what the newest one changes.
If it doesn't work
- Servers in a project
.mcp.jsonstay inactive until you approve them the first time Claude Code starts in that folder. claude mcp addsaves to the local scope by default: only you, only this project. Add--scope userto use it in every project.- If a server shows as failed, run
claude --debugto see its startup output.





