Skip to content

Connect GitHub MCP to VS 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

  • VS 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_TOKEN in your environment. To skip Docker, use GitHub MCP (remote), the hosted version.
  1. Step 1: Add GitHub MCP to VS Code

    Add it from the terminal

    Adds the server to your VS Code profile, so it works in every workspace.

    Terminal
    code --add-mcp '{"name":"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":"${env:GITHUB_PERSONAL_ACCESS_TOKEN}"}}'

    Or add it to the workspace

    Add this to .vscode/mcp.json and commit it to share it with your team.

    .vscode/mcp.json
    {
      "servers": {
        "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": "${env:GITHUB_PERSONAL_ACCESS_TOKEN}"
          }
        }
      }
    }
  2. Step 2: Check it's connected

    Run MCP: List Servers from the Command Palette, then open Copilot Chat in Agent mode and check the tools picker.

  3. Step 3: Try a first request

    Ask VS Code something that only works with GitHub MCP connected:

    Say to VS Code
    List the open pull requests in this repository and summarise what the newest one changes.

If it doesn't work

  • VS Code asks you to trust a server the first time it starts. Accept it, or the tools stay hidden.
  • code --add-mcp writes to your user profile, so the server works in every workspace.
  • Use MCP: List Servers → Show Output to see startup errors.