Problem it solves

You’re mid-session, deep in a refactor, and you need to check PR #142 for context. The old workflow: stop, switch to browser, find the PR, read the diff, come back, lose your train of thought. This happens a dozen times a day.

The GitHub MCP Server eliminates that context switch entirely. Once installed, Claude can read PRs, list issues, search your codebase on GitHub, and even create or update issues — all without leaving your terminal session.

How to install

The current official method uses HTTP transport directly to GitHub’s Copilot MCP endpoint. The old @modelcontextprotocol/server-github npm package is archived — do not use it.

Terminal window
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

After running that command, start a new Claude Code session and run /mcp to verify the server is listed and active. You’ll be prompted to authenticate via GitHub OAuth on first use — complete that flow in the browser, then you’re done. Authentication persists across sessions.

How to use

Once installed, talk to Claude naturally:

  • “Review PR #142 and summarize the changes”
  • “List open issues labeled ‘bug’ in this repo”
  • “Search the repo for all uses of fetchUser”
  • “Create an issue: Authentication fails when token expires”
  • “What’s the status of the CI checks on PR #89?”

Claude handles the GitHub API calls behind the scenes. You never type a gh command or leave your session.

Pro tips

Combine with git commands. Use the GitHub MCP for reading PR context and issue details, then use Claude’s native git abilities (git commit, git push) to act. The combination covers the full PR workflow without a browser.

Reference issues in commits. Ask Claude: “Commit this with a message referencing issue #23.” It’ll format the commit message correctly to auto-close the issue on merge.

Search before you build. Before writing a new function, ask: “Search this repo for existing implementations of X.” Saves you from duplicating code that already exists somewhere in the codebase.

When NOT to use

Skip GitHub MCP for simple local git operations — git status, git diff, git log. Claude handles those natively without any MCP server. The GitHub MCP adds value specifically when you need to interact with the remote: PRs, issues, Actions, and GitHub search.