GitHub MCP Server (remote)

GitHub's hosted endpoint for its official MCP server, with the same repository, issue and pull request tools and no Docker. These examples send a GitHub personal access token in an Authorization header.

Remote (HTTP)Credential

Set up GitHub MCP Server (remote)

Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.

Claude Code

Run in your terminal.

claude mcp add --transport http github-remote https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer $GITHUB_PERSONAL_ACCESS_TOKEN"

Cursor

Merge into ~/.cursor/mcp.json

{
  "mcpServers": {
    "github-remote": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer REPLACE_WITH_GITHUB_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}

Codex

Run in your terminal.

codex mcp add github-remote --url https://api.githubcopilot.com/mcp/ --bearer-token-env-var GITHUB_PERSONAL_ACCESS_TOKEN

Gemini CLI

Merge into ~/.gemini/settings.json

{
  "mcpServers": {
    "github-remote": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer REPLACE_WITH_GITHUB_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}

OpenCode

Merge into ~/.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "github-remote": {
      "type": "remote",
      "url": "https://api.githubcopilot.com/mcp/",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer REPLACE_WITH_GITHUB_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}

VS Code

Merge into .vscode/mcp.json

{
  "servers": {
    "github-remote": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  },
  "inputs": [
    {
      "id": "GITHUB_PERSONAL_ACCESS_TOKEN",
      "type": "promptString",
      "description": "GITHUB_PERSONAL_ACCESS_TOKEN",
      "password": true
    }
  ]
}

Using more than one server?Add to a config with other servers

Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, add the URL as a custom connector. This is a remote server; see remote vs local servers and authentication and security basics.

Overview

This is the hosted version of the GitHub MCP Server, run by GitHub at https://api.githubcopilot.com/mcp/. It is the same project as the local github-official listing, so it offers the same default toolsets, but nothing runs on your machine and Docker isn't needed. GitHub's README calls it the easiest way to get started and points hosts without remote support to the local server instead.

Tools are grouped into toolsets. The default set includes get_file_contents and search_code for reading code, issue_read and issue_write for triage, and pull_request_read and create_pull_request for review work. GitHub's remote server documentation lists a separate URL for each toolset, such as /mcp/x/issues, and adding /readonly to a URL limits it to read-only tools. A few toolsets exist only on the remote server.

The examples here send a personal access token in an Authorization: Bearer header, which GitHub says any host with remote MCP support should accept. Codex reads the token from an environment variable you name. OAuth works only in hosts that have set up a GitHub App or OAuth App, such as VS Code. Give the token the narrowest repository access and permissions your task needs. GitHub Enterprise Server can't use this endpoint; use the local server instead.

Example tools

  • get_file_contents
  • search_code
  • issue_read
  • issue_write
  • pull_request_read
  • create_pull_request

Tool names are upstream examples. The server's live tool list can differ.

Browse Developer Tools servers

Sources

This page was written from the upstream documentation below and last reviewed on 17 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.