Remote GitHub MCP Server 🚀

With this release we document how to use our new hosted server!

The remote GitHub MCP Server is hosted by GitHub and provides the easiest method for getting up and running. If your MCP host does not support remote MCP servers, don't worry! You can use the local version of the GitHub MCP Server instead.

Prerequisites

1. An MCP host that supports the latest MCP specification and remote servers, such as VS Code.

Installation

Usage with VS Code

For quick installation, use one of the one-click install buttons above. Once you complete that flow, toggle Agent mode (located by the Copilot Chat text input) and the server will start.

Usage in other MCP Hosts

For MCP Hosts that have been configured to use the remote GitHub MCP Server, add the following JSON block to the host's configuration:

{
  "mcp": {
    "servers": {
      "github": {
        "type": "http",
        "url": "https://api.githubcopilot.com/mcp/"
      }
    }
  }
}

Note: The exact configuration format may vary by host. Refer to your host's documentation for the correct syntax and location for remote MCP server setup.

What's Changed

• Remove non-existent get_line_number_in_pull_request_file tool reference by @TheoBrigitte in #436
• Bump mcp-go to 0.30.0 by @williammartin in #440
• Remove test that can panic by @williammartin in #445
• Used typed tool handler for get_me tool by @williammartin in #447
• Bump go-github to v72.0.0 by @radar07 in #456
• fix: use ENTRYPOINT and CMD for proper argument handling by @JAORMX in #454
• Fix missing go-github v72 license bump by @williammartin in #467
• build(deps): bump github.com/mark3labs/mcp-go from 0.30.0 to 0.31.0 by @dependabot in #465
• Add GitHub Enterprise Cloud with data residency (ghe.com) to readme by @malantin in #448
• Reduce fields in search_users response by @SamMorrowDrums in #485
• chore: separate toolset creation from init and use typed error by @SamMorrowDrums in #487
• fix: move defaulted 'state' param after non-default params in list_code_scanning_alerts by @ph3t in #488
• docs: add read-only instruction to readme by @radar07 in #490
• Export ToBoolPtr and RequiredParam by @LuluBeatson in #495
• Add context toolset and adjust readme by @SamMorrowDrums in #499
• Fix typo in README.md by @jaril in #502
• use better raw file handling and return resources by @SamMorrowDrums in #505
• docs: Update README.md by @SamMorrowDrums in #508

New Contributors

• @TheoBrigitte made their first contribution in #436
• @JAORMX made their first contribution in #454
• @malantin made their first contribution in #448
• @ph3t made their first contribution in #488
• @LuluBeatson made their first contribution in #495
• @jaril made their first contribution in #502

Full Changelog: v0.4.0...v0.5.0

New Tools

• Assign GitHub Copilot to issues: meet the new coding agent.
• 🔔 Tools to list/manage notifications and subscriptions.
• Create pending pull request reviews, add review comments, and then submit the review when done!
  • This also fixes a bug where some users experiences json schema validation issues with the previous pull request review tool.

What's Changed

• fix: update get_me reason arg description by @toby in #403
• Alter the description of get-me to reduce redundant repeat calls by @SamMorrowDrums in #411
• Split PR review creation, commenting, submission and deletion by @williammartin in #410
• feat: add golangci-lint-action to the lint workflow by @radar07 in #407
• build(deps): bump github.com/mark3labs/mcp-go from 0.27.0 to 0.28.0 by @dependabot in #412
• Support assigning copilot to issues by @williammartin & @martinajir in #418
• feat: add GitHub notifications tools for managing user notifications by @sridharavinash in #225

New Contributors

• @sridharavinash made their first contribution in #225
• @martinajir made their first contribution in #418

Full Changelog: v0.3.0...v0.4.0

Main features

Tool Annotations

With user friendly labels, and read-only hints MCP host applications can show improved UI, and allow you to call read-only tools without needing confirmation. Check out this brief demo of the annotations support in copilot agent mode in VSCode and notice how it doesn't ask for confirmation when listing issues, but it does before creating an issue:

This is a massive UX improvement!

New Tools

• Request Copilot Code Reviews
• 🛑 Delete files
• 🏷️ Git tag operations

What's Changed

• chore(deps): bump github.com/docker/docker from 28.0.4+incompatible to 28.1.1+incompatible by @dependabot in #323
• chore(deps): bump github.com/mark3labs/mcp-go from 0.20.1 to 0.22.0 by @dependabot in #324
• Gitignore .vscode except launch.json by @williammartin in #329
• Remove conformance tests by @williammartin in #331
• Add simple e2e test by @williammartin in #330
• feat: provide tool annotations by @SamMorrowDrums in #308
• fix: update params for search_users by @warjiang in #327
• small doc change : fixing formatting in list of tool functions by @divyanshvn in #317
• Update README.md to remove mcp key on .vscode/mcp.json example by @fuentesjr in #186
• Bump golang from 1.23.7 to 1.24.2 by @dependabot in #159
• Pre-reqs for docker use: image is public, so docker pull errors likely mean expired token by @ismith in #282
• Ensure toolsets are configurable via env var by @williammartin in #348
• Fix: Specify sha is required for file update by @crondinini in #320
• feat: Add support for Git tag operations by @eranco74 in #345
• build(deps): bump github.com/mark3labs/mcp-go from 0.22.0 to 0.25.0 by @dependabot in #375
• build(deps): bump github.com/migueleliasweb/go-github-mock from 1.1.0 to 1.3.0 by @dependabot in #377
• Support debugging e2e tests by @williammartin in #380
• Optimize Docker build with bind mounts by @Juneezee in #208
• Improve README by including config example for gh-host flag by @rajbos in #335
• Fix a typo by @mntlty in #385
• Change code fence to neutral ```console by @codingoutloud in #389
• feat: upgrade golangci-lint to v2 by @radar07 in #386
• build(deps): bump golang from 1.24.2-alpine to 1.24.3-alpine by @dependabot in #395
• build(deps): bump github.com/mark3labs/mcp-go from 0.25.0 to 0.27.0 by @dependabot in #397
• feat: add DeleteFile tool to delete files from GitHub repositories by @ashwin-ant in #356
• Add ability to request Copilot reviews via MCP by @aryasoni98 in #387

New Contributors

• @dependabot made their first contribution in #323
• @warjiang made their first contribution in #327
• @divyanshvn made their first contribution in #317
• @fuentesjr made their first contribution in #186
• @ismith made their first contribution in #282
• @crondinini made their first contribution in #320
• @eranco74 made their first contribution in #345
• @rajbos made their first contribution in #335
• @codingoutloud made their first contribution in #389
• @radar07 made their first contribution in #386

Full Changelog: v0.2.1...v0.3.0

What's Changed

• Update README.md to explain Agent mode will start the server by @srt32 in #305
• fix: use anyOf instead of nullable type array by @toby in #325
  • This should fix a bug preventing users of Windsurf from executing the server.

New Contributors

• @srt32 made their first contribution in #305

Full Changelog: v0.2.0...v0.2.1

The v0.2.0 release introduces a couple of major changes 🚀 :

• Explicitly enable groups of tools like issues or pull_requests.
• Experimental Dynamic Tool Discovery and provide feedback if you love it ❤️ , hate 😭 it or encountered any issues 👾.
• The ENV var for setting the github host for enterprise has changed to GITHUB_HOST from GH_HOST. The --gh-host flag remains unchanged.

You can find instructions for enabling these features in your

To upgrade, be sure to first run:

docker pull ghcr.io/github/github-mcp-server:latest

Then restart the server in your MCP host application!

Changelog

What's Changed

• chore: Standardize 'licence' to 'license' spelling by @3mini in #158
• chore: Remove unnecessary trailing periods from descriptions by @mururu in #170
• chore: export code scanning funcs by @SamMorrowDrums in #162
• chore: export issues funcs by @SamMorrowDrums in #163
• chore: export pr funcs by @SamMorrowDrums in #164
• chore: export repository funcs by @SamMorrowDrums in #166
• chore: export search funcs by @SamMorrowDrums in #167
• chore: export remaining + helpers by @SamMorrowDrums in #168
• fix: enhance Docker publish workflow with additional tagging options by @MayorFaj in #160
• Generate GitHub Artifact Attestations by @suzuki-shunsuke in #174
• Indicate Go API stability in README by @williammartin in #175
• remove pretty print json flag by @mntlty in #179
• feat: Add update_pull_request tool by @monotykamary in #122
• Fix handling nil values for optional string array parameters, by @A-Georgiou in #194
• chore: groundwork for multi-user to server by @SamMorrowDrums in #195
• docs: fix CODEOWNERS syntax by @Juneezee in #184
• Make it clear that Docker needs to be running by @chiedo in #214
• Add tool for getting a single commit (includes stats, files) by @jshorty in #216
• Allow passing through server options by @omgitsads in #218
• Add ability to view branches for a repo #141 by @aryasoni98 in #205
• Prefer already-defined endpoint mock by @jshorty in #226
• chore:update CONTRIBUTING.md style guide link by @omihirofumi in #234
• Add tools for one-off PR comments and replying to PR review comments by @ashwin-ant in #143
• chore: extend user agent by @SamMorrowDrums in #237
• feat: pretty-print JSONL text responses in mcpcurl by @simondanielsson in #239
• Add clarity to the "Build from source" option by @rfearing in #264
• feat: partition tools by product/feature by @SamMorrowDrums in #188
• feat: add version subcommand to display build metadata by @joe-ton in #119
• Add missing enum constraints by @tonytrg in #278
• Add Tool Name property for List Code Scanning Alerts tool by @Dylan-Rinker in #272
• Adding SecretScanning Toolset by @tonytrg in #280
• Update CODEOWNERS to github-mcp-server team by @williammartin in #301
• fix: update json schema for create_pull_request_review by @toby in #300
• chore: update readme for tool parititioning by @SamMorrowDrums in #274

New Contributors

• @3mini made their first contribution in #158
• @mururu made their first contribution in #170
• @MayorFaj made their first contribution in #160
• @suzuki-shunsuke made their first contribution in #174
• @monotykamary made their first contribution in #122
• @A-Georgiou made their first contribution in #194
• @Juneezee made their first contribution in #184
• @jshorty made their first contribution in #216
• @omgitsads made their first contribution in #218
• @aryasoni98 made their first contribution in #205
• @omihirofumi made their first contribution in #234
• @simondanielsson made their first contribution in #239
• @joe-ton made their first contribution in #119
• @tonytrg made their first contribution in #278
• @Dylan-Rinker made their first contribution in #272

Full Changelog: v0.1.1...v0.2.0

What's Changed

• Fix VS Code inputs link by @digitarald in #103
• add vscode launch configuration by @mntlty in #104
• Make pre-requisites more scannable by @chiedo in #107
• Update CONTRIBUTING.md to fix link to LICENSE file by @Jeffrey-Luszcz in #109
• feature request template by @mntlty in #115
• pretty print json by @mntlty in #114
• fix issue with pagination in search_repositories by @juruen in #129
• chore: add code scanning advanced setup yml by @SamMorrowDrums in #148
• Add support for retrieving GitHub Issue Comments by @almostwhitehat in #106
• Add line parameter support to create_pull_request_review tool by @ashwin-ant in #118
• Use github.Ptr instead of smithy-go/ptr by @ohkinozomu in #147
• pkg/github: fix use of per page parameter by @AlexanderYastrebov in #137
• Removed duplicated createIssue tool definition by @kpumuk in #152
• Fix a typo in repository_resource.go by @szepeviktor in #125
• add script to pretty print server log by @juruen in #146
• chore: pass version through to server by @SamMorrowDrums in #155

New Contributors

• @chiedo made their first contribution in #107
• @Jeffrey-Luszcz made their first contribution in #109
• @almostwhitehat made their first contribution in #106
• @ashwin-ant made their first contribution in #118
• @ohkinozomu made their first contribution in #147
• @AlexanderYastrebov made their first contribution in #137
• @kpumuk made their first contribution in #152
• @szepeviktor made their first contribution in #125

Full Changelog: v0.1.0...v0.1.1

Initial Release

This is the first release if the v0.1.0 of the GitHub MCP Server. 🚀

Setup instructions: https://github.com/github/github-mcp-server?tab=readme-ov-file#github-mcp-server
Docker image: https://github.com/github/github-mcp-server/pkgs/container/github-mcp-server/388906515?tag=v0.1.0

What's Changed

• Use full go version by @SamMorrowDrums in #7
• fix: added reason argument to get_me function by @toby in #8
• feat: add basic code scanning methods by @SamMorrowDrums in #11
• chore: remove deprecated func by @SamMorrowDrums in #10
• fix issue with log-file arg by @juruen in #13
• add initial tests by @juruen in #14
• add iologger for debugging purposes by @juruen in #15
• add instructions on how to test the server with VS Code by @juruen in #17
• feature: repo resource by @SamMorrowDrums in #16
• docs: add oss documentation by @toby in #21
• change some descriptions by @juruen in #23
• chore: add dockerfile by @SamMorrowDrums in #27
• chore: Create docker-publish.yml by @SamMorrowDrums in #30
• add create_issue tool by @juruen in #18
• add support for list_issues by @juruen in #26
• feat: add a framework for translations by @SamMorrowDrums in #25
• feat: read-only flag by @SamMorrowDrums in #29
• Simplify vscode MCP setup with input by @connor4312 in #19
• add support for the update_issue tool by @juruen in #32
• add support for the create_pull_request_review_tool by @juruen in #33
• add support for the push_files tool by @juruen in #34
• add ci build job by @juruen in #36
• fix array schemas by @juruen in #37
• validate tools params by @juruen in #35
• feat: enterprise host support by @SamMorrowDrums in #28
• fix: mention "me" and "my" in get_me description by @toby in #40
• fix: add required fields for OpenAI API by @toby in #39
• [docker] build arm64 by @juruen in #42
• add basic linter workflow by @juruen in #41
• update install instructions by @juruen in #43
• Use a config filename that is different from the binary name by @williammartin in #46
• Update VS Code config JSON by @williammartin in #45
• Add initial conformance test by @williammartin in #48
• set user agent for client requests by @mntlty in #61
• chore: add oss licenses by @SamMorrowDrums in #57
• docs: update README by @toby in #58
• add support for create_pull_request by @juruen in #63
• docs: add license section to readme by @toby in #65
• fix: don't lint markdown by @toby in #67
• fix: run lint in all circumstances by @SamMorrowDrums in #68
• repository resource tests by @mntlty in #69
• chore: go releaser by @SamMorrowDrums in #71
• chore: remove licences from the goreleaser steps by @SamMorrowDrums in #72
• chore: add ld flags so version is included in docker releases by @SamMorrowDrums in #73
• chore: set build arg for publishing version by @SamMorrowDrums in #74
• chore: correct build arg syntax by @SamMorrowDrums in #75
• chore: update deps by @SamMorrowDrums in #76
• chore: document latest tag rather than main by @SamMorrowDrums in #77
• pull request and bug report template by @mntlty in #84
• address pull request feedback by @mntlty in #87
• Use arrays rather than CSV by @williammartin in #82
• Enumerate strings in schema by @williammartin in #85
• Add boundaries to pagination by @williammartin in #86
• speed up docker builds by @mntlty in #92
• assert request params in code_scanning_test by @juruen in #94
• assert request params and body in pull_request_test by @juruen in #95
• assert params and body in repositories_test by @juruen in #96
• Add missing milestone to create_issue by @williammartin in #88
• assert query params in search_test by @juruen in #97
• Remove non-existent README property by @williammartin in #99
• chore: support x-platform licence generation by @SamMorrowDrums in #98
• Conform list tools by @williammartin in #90
• VS Code install steps by @digitarald in #102

New Contributors

• @toby made their first contribution in #8
• @juruen made their first contribution in #13
• @connor4312 made their first contribution in #19
• @mntlty made their first contribution in #61

Full Changelog: https://github.com/github/github-mcp-server/commits/v0.1.0

RC3

Bugfix release.

What's Changed

• Add optional string array param by @williammartin in #101

Full Changelog: v0.1.0-rc.2...v0.1.0-rc.3

Release Candidate 2

• Major change is tool names are now camelCase 🚀

What's Changed

• speed up docker builds by @mntlty in #92
• assert request params in code_scanning_test by @juruen in #94
• assert request params and body in pull_request_test by @juruen in #95
• assert params and body in repositories_test by @juruen in #96
• Add missing milestone to create_issue by @williammartin in #88
• assert query params in search_test by @juruen in #97
• Remove non-existent README property by @williammartin in #99
• chore: support x-platform licence generation by @SamMorrowDrums in #98
• Conform list tools by @williammartin in #90

Full Changelog: v0.1.0-rc.1...v0.1.0-rc.2

Initial Release Candidate

This is the first release candidate for the v0.1.0 of the GitHub MCP Server. 🚀

What's Changed

• Use full go version by @SamMorrowDrums in #7
• fix: added reason argument to get_me function by @toby in #8
• feat: add basic code scanning methods by @SamMorrowDrums in #11
• chore: remove deprecated func by @SamMorrowDrums in #10
• fix issue with log-file arg by @juruen in #13
• add initial tests by @juruen in #14
• add iologger for debugging purposes by @juruen in #15
• add instructions on how to test the server with VS Code by @juruen in #17
• feature: repo resource by @SamMorrowDrums in #16
• docs: add oss documentation by @toby in #21
• change some descriptions by @juruen in #23
• chore: add dockerfile by @SamMorrowDrums in #27
• chore: Create docker-publish.yml by @SamMorrowDrums in #30
• add create_issue tool by @juruen in #18
• add support for list_issues by @juruen in #26
• feat: add a framework for translations by @SamMorrowDrums in #25
• feat: read-only flag by @SamMorrowDrums in #29
• Simplify vscode MCP setup with input by @connor4312 in #19
• add support for the update_issue tool by @juruen in #32
• add support for the create_pull_request_review_tool by @juruen in #33
• add support for the push_files tool by @juruen in #34
• add ci build job by @juruen in #36
• fix array schemas by @juruen in #37
• validate tools params by @juruen in #35
• feat: enterprise host support by @SamMorrowDrums in #28
• fix: mention "me" and "my" in get_me description by @toby in #40
• fix: add required fields for OpenAI API by @toby in #39
• [docker] build arm64 by @juruen in #42
• add basic linter workflow by @juruen in #41
• update install instructions by @juruen in #43
• Use a config filename that is different from the binary name by @williammartin in #46
• Update VS Code config JSON by @williammartin in #45
• Add initial conformance test by @williammartin in #48
• set user agent for client requests by @mntlty in #61
• chore: add oss licenses by @SamMorrowDrums in #57
• docs: update README by @toby in #58
• add support for create_pull_request by @juruen in #63
• docs: add license section to readme by @toby in #65
• fix: don't lint markdown by @toby in #67
• fix: run lint in all circumstances by @SamMorrowDrums in #68
• repository resource tests by @mntlty in #69
• chore: go releaser by @SamMorrowDrums in #71
• chore: remove licences from the goreleaser steps by @SamMorrowDrums in #72
• chore: add ld flags so version is included in docker releases by @SamMorrowDrums in #73
• chore: set build arg for publishing version by @SamMorrowDrums in #74
• chore: correct build arg syntax by @SamMorrowDrums in #75
• chore: update deps by @SamMorrowDrums in #76
• chore: document latest tag rather than main by @SamMorrowDrums in #77
• pull request and bug report template by @mntlty in #84
• address pull request feedback by @mntlty in #87
• Use arrays rather than CSV by @williammartin in #82
• Enumerate strings in schema by @williammartin in #85
• Add boundaries to pagination by @williammartin in #86

New Contributors

• @toby made their first contribution in #8
• @juruen made their first contribution in #13
• @connor4312 made their first contribution in #19
• @mntlty made their first contribution in #61

Full Changelog: https://github.com/github/github-mcp-server/commits/v0.1.0-rc.1