# GitHub MCP Server

> Work with repositories, issues, pull requests and Actions on GitHub from your agent, through GitHub's own MCP server.

GitHub's own MCP server connects your agent to GitHub. Ask in plain words, and it reads repositories and code, manages issues and pull requests, follows Actions runs and security findings, and more, across any repository you have access to.

What you can do with it
- Browse and search code, files and commits, and understand how a project is put together
- Create, update and triage issues, and open, review and merge pull requests
- Follow GitHub Actions runs, look into failed builds and manage releases
- Review code scanning, secret scanning and Dependabot alerts
- Work with discussions, notifications, projects and gists
- Assign an issue to Copilot or ask Copilot for a review

How it connects
- Hosted: GitHub runs it at https://api.githubcopilot.com/mcp/. VS Code signs you in with GitHub; agents such as Claude Code send a GitHub personal access token.
- Local: run it with Docker (ghcr.io/github/github-mcp-server) or as a binary. On github.com it opens a GitHub sign-in in your browser the first time, or you can give it a personal access token.
- In Gemini CLI it installs as an extension: gemini extensions install https://github.com/github/github-mcp-server
- GitHub's install guides cover Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, GitHub Copilot and more.

Choose what it can do
- It starts with a default set of tools (context, repositories, issues, pull requests and users). Turn on more toolsets, such as Actions or code security, when you need them.
- Read-only when you want it: the hosted address https://api.githubcopilot.com/mcp/readonly, or --read-only on the local server, only offers tools that read.
- It also works with GitHub Enterprise Server and GitHub Enterprise Cloud with data residency (ghe.com).

- Type: Plugin
- Made by: GitHub
- Category: Developer tools
- Formats: Remote MCP, Local MCP, Extensions
- Version: 1.0.0
- Source: https://github.com/github/github-mcp-server
- Page: https://pluginboard.ai/plugins/github

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `Authorization` (optional): Authorization header with authentication token (PAT or App token)

Replace each `<NAME>` placeholder with your own value.

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://api.githubcopilot.com/mcp/ under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://api.githubcopilot.com/mcp/

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://api.githubcopilot.com/mcp/. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://api.githubcopilot.com/mcp/". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://api.githubcopilot.com/mcp/

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://api.githubcopilot.com/mcp/ and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22github-mcp-server%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2F%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http github-mcp-server https://api.githubcopilot.com/mcp/
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=github-mcp-server&config=eyJ1cmwiOiJodHRwczovL2FwaS5naXRodWJjb3BpbG90LmNvbS9tY3AvIn0%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "github-mcp-server": {
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http github-mcp-server https://api.githubcopilot.com/mcp/
```

### Codex

Run in your terminal:

```shell
codex mcp add github-mcp-server --url https://api.githubcopilot.com/mcp/
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "github-mcp-server": {
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini extensions install https://github.com/github/github-mcp-server
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://api.githubcopilot.com/mcp/ (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add github-mcp-server --url https://api.githubcopilot.com/mcp/ --transport streamable-http
```

If it needs a key or sign-in: For https://api.githubcopilot.com/mcp/, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login github-mcp-server.

### OpenCode

Run in your terminal:

```shell
opencode mcp add github-mcp-server --url https://api.githubcopilot.com/mcp/
```

If it needs a key: For https://api.githubcopilot.com/mcp/, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add github-mcp-server --url https://api.githubcopilot.com/mcp/
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "github-mcp-server": {
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}
```

If it signs in with OAuth: If https://api.githubcopilot.com/mcp/ asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).