Skip to content

GitHub MCP

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 serverCode and QAWorks through the Grid

Runs on your machine

Your agent, or the Grid, starts this command and talks to it over standard input and output.
docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Needs these environment variables: GITHUB_PERSONAL_ACCESS_TOKEN

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_TOKEN in your environment. To skip Docker, use GitHub MCP (remote), the hosted version.

Set it up in your agent

Pick your agent and copy the setup. ExonUI remembers your choice on other pages.
  1. 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-server
  2. Or share it with your team

    Add this to .mcp.json at 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.

Check it works

Terminal
claude mcp list

Start a session and run /mcp to see the server, its status and its tools.