Setting up the GitHub MCP Server
Learn how to configure the GitHub Model Context Protocol (MCP) server.
Tool navigation
In this article
- About the GitHub MCP server
- Prerequisites
- Setting up the GitHub MCP server in Visual Studio Code
- About the GitHub MCP server
- Prerequisites
- Setting up the GitHub MCP server in Visual Studio
- About the GitHub MCP server
- Prerequisites
- Setting up the GitHub MCP server in JetBrains IDEs
- About the GitHub MCP server
- Prerequisites
- Setting up the GitHub MCP server in Xcode
- About the GitHub MCP server
- Prerequisites
- Setting up the GitHub MCP server in Eclipse
- Enterprise configuration
- Next steps
The GitHub MCP server is available to all GitHub users regardless of plan type. However, specific tools within the MCP server inherit the same access requirements as their corresponding GitHub features. If a feature requires a paid GitHub or Copilot license, the equivalent MCP tool will require the same subscription. For example, tools that interact with Copilot Coding Agent require a paid Copilot license.
For the latest information and updates, see theGitHub MCP server repository.
About the GitHub MCP server
The GitHub MCP server is a Model Context Protocol (MCP) server provided and maintained by GitHub. MCP allows you to integrate AI capabilities with other tools and services, enhancing your development experience by providing context-aware AI assistance.
For a full introduction to the GitHub MCP server and an overview of MCP, seeAbout Model Context Protocol (MCP).
Prerequisites
- A GitHub account.
- Visual Studio Code.
- If you are a member of an organization or enterprise with a Copilot Business or Copilot Enterprise plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.
Setting up the GitHub MCP server in Visual Studio Code
The GitHub MCP server in Visual Studio Code can be configured remotely or locally. The remote GitHub MCP server is hosted by GitHub and is the recommended option for most users. The local GitHub MCP server is hosted on your machine and is recommended for users who want to customize their setup or have specific security requirements.
The steps below describe remote configuration through the MCP marketplace in Visual Studio Code's extension panel. The MCP marketplace is powered by the GitHub MCP Registry. SeeMCP Registry.
For information on manually configuring the remote or local GitHub MCP server, see theGitHub MCP server documentation.
- In Visual Studio Code, open the extensions panel by clicking the extensions icon in the sidebar or pressingCtrl+Shift+X (Windows/Linux) /Command+Shift+X (Mac).
- In the extensions search bar, click the filter icon and selectMCP Server from the dropdown.
- If it is your first time using the MCP Servers Marketplace, follow the prompts on screen to enable the Marketplace.
- In the search bar, type
githuband select the GitHub MCP server from the search results. - On the GitHub MCP server configuration page, clickInstall.
- To check that the GitHub MCP server is configured correctly, open the command palette by pressingCtrl+Shift+P (Windows/Linux) /Command+Shift+P (Mac).
- Type and selectMCP: List Servers. You should see
githublisted as a configured server.
About the GitHub MCP server
The GitHub MCP server is a Model Context Protocol (MCP) server provided and maintained by GitHub. MCP allows you to integrate AI capabilities with other tools and services, enhancing your development experience by providing context-aware AI assistance.
For a full introduction to the GitHub MCP server and an overview of MCP, seeAbout Model Context Protocol (MCP).
Prerequisites
- Access to Copilot. SeeWhat is GitHub Copilot?.
- Visual Studio version 17.14 or later. For more information on installing Visual Studio, see theVisual Studio downloads page.
- Sign in to GitHub from Visual Studio.
- If you are a member of an organization or enterprise with a Copilot Business or Copilot Enterprise plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.
Setting up the GitHub MCP server in Visual Studio
The instructions below guide you through setting up the GitHub MCP server in Visual Studio. Other MCP-compatible editors may have similar steps, but the exact process may vary.
The remote GitHub MCP server uses one-click OAuth authentication by default, but you can also manually configure it to use a personal access token (PAT) for authentication. If you use OAuth, the MCP server can only access the scopes you approve during sign-in. In organization-owned contexts, access may also be limited by admin policies that control which scopes and apps are permitted. If you use a PAT, the MCP server will have access to the scopes granted by the PAT, which is also subject to any PAT restrictions configured by the organization.
Note
If you are an Enterprise Managed User, then PAT is disabled by default, unless enabled by an enterprise administrator. If PAT is disabled, you won't be able to use PAT authentication. If you have OAuth access policy restrictions, you will need the OAuth App for each client (MCP host application) to be enabled (except Visual Studio Code and Visual Studio).
For information on setting up the GitHub MCP server locally, see theGitHub MCP server documentation.
Remote MCP server configuration with OAuth
You do not need to create a PAT or install any additional software to use the remote GitHub MCP server with OAuth. You can set it up directly in Visual Studio.
In the Visual Studio menu bar, clickView, then clickGitHub Copilot Chat.
At the bottom of the chat panel, selectAgent from the mode dropdown.
In the Copilot Chat window, click the tools icon, then click the plus icon in the tool picker window.
In the "Configure MCP server" pop-up window, fill out the fields.
- For "Server ID", type
github. - For "Type", select "HTTP/SSE" from the dropdown.
- For "URL", type
https://api.githubcopilot.com/mcp/.
- For "Server ID", type
ClickSave. The configuration in the
mcp.jsonfile should look like this:JSON { "servers": { "github": { "url": "https://api.githubcopilot.com/mcp/" } } }{"servers":{"github":{"url":"https://api.githubcopilot.com/mcp/"}}}In the
mcp.jsonfile, clickAuth from the CodeLens above the server to authenticate to the server. A pop-up will come up allowing you to authenticate with your GitHub account.
Remote MCP server configuration with PAT
To configure the remote GitHub MCP server with a PAT, ensure you have created a PAT with the necessary scopes for the access you want to grant to the MCP server. For more information, seeManaging your personal access tokens.
In the Visual Studio menu bar, clickView, then clickGitHub Copilot Chat.
At the bottom of the chat panel, selectAgent from the mode dropdown.
In the Copilot Chat window, click the tools icon, then click the plus icon in the tool picker window.
In the "Configure MCP server" pop-up window, fill out the fields.
- For "Server ID", type
github. - For "Type", select "HTTP/SSE" from the dropdown.
- For "URL", type
https://api.githubcopilot.com/mcp/. - Add a new header under "Headers", called "Authorization" and set to the value
Bearer YOUR_GITHUB_PAT, replacing "YOUR_GITHUB_PAT" with your PAT.
- For "Server ID", type
ClickSave. The configuration in the
mcp.jsonfile should look like this:JSON { "servers": { "github": { "url": "https://api.githubcopilot.com/mcp/", "requestInit": { "headers": { "Authorization": "Bearer YOUR_GITHUB_PAT" } } } } }{"servers":{"github":{"url":"https://api.githubcopilot.com/mcp/","requestInit":{"headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}}}}
For more information on configuring MCP servers in Visual Studio, seeUse MCP servers in Visual Studio (Preview) in the Visual Studio documentation.
About the GitHub MCP server
The GitHub MCP server is a Model Context Protocol (MCP) server provided and maintained by GitHub. MCP allows you to integrate AI capabilities with other tools and services, enhancing your development experience by providing context-aware AI assistance.
For a full introduction to the GitHub MCP server and an overview of MCP, seeAbout Model Context Protocol (MCP).
Prerequisites
Access to Copilot. SeeWhat is GitHub Copilot?.
A compatible JetBrains IDE. GitHub Copilot is compatible with the following IDEs:
- IntelliJ IDEA (Ultimate, Community, Educational)
- Android Studio
- AppCode
- CLion
- Code With Me Guest
- DataGrip
- DataSpell
- GoLand
- JetBrains Client
- MPS
- PhpStorm
- PyCharm (Professional, Community, Educational)
- Rider
- RubyMine
- RustRover
- WebStorm
- Writerside
See theJetBrains IDEs tool finder to download.
Latest version of the GitHub Copilot extension. See theGitHub Copilot plugin in the JetBrains Marketplace. For installation instructions, seeInstalling the GitHub Copilot extension in your environment.
Sign in to GitHub in your JetBrains IDE. For authentication instructions, seeInstalling the GitHub Copilot extension in your environment.
If you are a member of an organization or enterprise with a Copilot Business or Copilot Enterprise plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.
Setting up the GitHub MCP server in JetBrains IDEs
The instructions below guide you through setting up the GitHub MCP server in JetBrains IDEs. Other MCP-compatible editors may have similar steps, but the exact process may vary.
The remote GitHub MCP server uses one-click OAuth authentication by default, but you can also manually configure it to use a personal access token (PAT) for authentication. If you use OAuth, the MCP server can only access the scopes you approve during sign-in. In organization-owned contexts, access may also be limited by admin policies that control which scopes and apps are permitted. If you use a PAT, the MCP server will have access to the scopes granted by the PAT, which is also subject to any PAT restrictions configured by the organization.
Note
If you are an Enterprise Managed User, then PAT is disabled by default, unless enabled by an enterprise administrator. If PAT is disabled, you won't be able to use PAT authentication. If you have OAuth access policy restrictions, you will need the OAuth App for each client (MCP host application) to be enabled (except Visual Studio Code and Visual Studio).
For information on setting up the GitHub MCP server locally, see theGitHub MCP server documentation.
Remote MCP server configuration with OAuth
You do not need to create a PAT or install any additional software to use the remote GitHub MCP server with OAuth. You can set it up directly in JetBrains IDEs.
In the lower right corner, click.
From the menu, select "Open Chat", make sure you are in Agent mode, then click the tools icon (called "Configure your MCP server") at the bottom of the chat window.
ClickAdd MCP Tools.
In the
mcp.jsonfile, add the following configuration:JSON { "servers": { "github": { "type": "http", "url": "https://api.githubcopilot.com/mcp/" } }}{"servers":{"github":{"type":"http","url":"https://api.githubcopilot.com/mcp/"}}}In the "GitHub Copilot" popup that says the "MCP server definition wants to authenticate to GitHub, clickAllow.
If you have not yet authorized the GitHub Copilot plugin, in the browser popup, clickContinue next to your personal account.
Remote MCP server configuration with PAT
To configure the remote GitHub MCP server with a PAT, ensure you have created a PAT with the necessary scopes for the access you want to grant to the MCP server. For more information, seeManaging your personal access tokens.
- In the lower right corner, click.
- From the menu, select "Open Chat", make sure you are in Agent mode, then click the tools icon (called "Configure your MCP server") at the bottom of the chat window.
- ClickAdd MCP Tools.
- In the
mcp.jsonfile, add the following configuration, replacingYOUR_GITHUB_PATwith the PAT you created:
{ "servers": { "github": { "url": "https://api.githubcopilot.com/mcp/", "requestInit": { "headers": { "Authorization": "Bearer YOUR_GITHUB_PAT" } } } } }{"servers":{"github":{"url":"https://api.githubcopilot.com/mcp/","requestInit":{"headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}}}}About the GitHub MCP server
The GitHub MCP server is a Model Context Protocol (MCP) server provided and maintained by GitHub. MCP allows you to integrate AI capabilities with other tools and services, enhancing your development experience by providing context-aware AI assistance.
For a full introduction to the GitHub MCP server and an overview of MCP, seeAbout Model Context Protocol (MCP).
Prerequisites
- Access to Copilot. SeeWhat is GitHub Copilot?.
- GitHub Copilot for Xcode extension. SeeInstalling the GitHub Copilot extension in your environment.
- If you are a member of an organization or enterprise with a Copilot Business or Copilot Enterprise plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.
Setting up the GitHub MCP server in Xcode
The instructions below guide you through setting up the GitHub MCP server in Xcode. Other MCP-compatible editors may have similar steps, but the exact process may vary.
The remote GitHub MCP server uses one-click OAuth authentication by default, but you can also manually configure it to use a personal access token (PAT) for authentication. If you use OAuth, the MCP server can only access the scopes you approve during sign-in. In organization-owned contexts, access may also be limited by admin policies that control which scopes and apps are permitted. If you use a PAT, the MCP server will have access to the scopes granted by the PAT, which is also subject to any PAT restrictions configured by the organization.
Note
If you are an Enterprise Managed User, then PAT is disabled by default, unless enabled by an enterprise administrator. If PAT is disabled, you won't be able to use PAT authentication. If you have OAuth access policy restrictions, you will need the OAuth App for each client (MCP host application) to be enabled (except Visual Studio Code and Visual Studio).
For information on setting up the GitHub MCP server locally, see theGitHub MCP server documentation.
Remote MCP server configuration with OAuth
You do not need to create a PAT or install any additional software to use the remote GitHub MCP server with OAuth. You can set it up directly in Xcode.
Open the GitHub Copilot for Xcode extension and go to "Settings".
- Alternatively, in an active Xcode workspace, you can find the settings by clickingEditor in the menu bar, selectingGitHub Copilot, then clickingOpen GitHub Copilot for Xcode Settings.
Select theMCP tab, then clickEdit Config.
Add the following configuration:
JSON { "servers": { "github": { "type": "http", "url": "https://api.githubcopilot.com/mcp/" } }}{"servers":{"github":{"type":"http","url":"https://api.githubcopilot.com/mcp/"}}}In the "GitHub Copilot" popup that says the "MCP Server Definition wants to authenticate to GitHub", clickContinue.
If you have not yet authorized the GitHub Copilot plugin, in the browser popup, clickContinue next to your personal account.
Remote MCP server configuration with PAT
To configure the remote GitHub MCP server with a PAT, ensure you have created a PAT with the necessary scopes for the access you want to grant to the MCP server. For more information, seeManaging your personal access tokens.
- Open the GitHub Copilot for Xcode extension and go to "Settings".
- Alternatively, in an active Xcode workspace, you can find the settings by clickingEditor in the menu bar, selectingGitHub Copilot, then clickingOpen GitHub Copilot for Xcode Settings.
- Select theMCP tab, then clickEdit Config.
- Add the following configuration, replacing
YOUR_GITHUB_PATwith the PAT you created:
{ "servers": { "github": { "url": "https://api.githubcopilot.com/mcp/", "requestInit": { "headers": { "Authorization": "Bearer YOUR_GITHUB_PAT" } } } } }{"servers":{"github":{"url":"https://api.githubcopilot.com/mcp/","requestInit":{"headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}}}}About the GitHub MCP server
The GitHub MCP server is a Model Context Protocol (MCP) server provided and maintained by GitHub. MCP allows you to integrate AI capabilities with other tools and services, enhancing your development experience by providing context-aware AI assistance.
For a full introduction to the GitHub MCP server and an overview of MCP, seeAbout Model Context Protocol (MCP).
Prerequisites
- Access to Copilot. SeeWhat is GitHub Copilot?.
- Compatible version of Eclipse. To use the GitHub Copilot extension, you must have Eclipse version 2024-09 or above. See theEclipse download page.
- If you are a member of an organization or enterprise with a Copilot Business or Copilot Enterprise plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.
- Latest version of the GitHub Copilot extension. Download this from theEclipse Marketplace. For more information, seeInstalling the GitHub Copilot extension in your environment.
- Sign in to GitHub from Eclipse.
Setting up the GitHub MCP server in Eclipse
The instructions below guide you through setting up the GitHub MCP server in Eclipse. Other MCP-compatible editors may have similar steps, but the exact process may vary.
The remote GitHub MCP server uses one-click OAuth authentication by default, but you can also manually configure it to use a personal access token (PAT) for authentication. If you use OAuth, the MCP server can only access the scopes you approve during sign-in. In organization-owned contexts, access may also be limited by admin policies that control which scopes and apps are permitted. If you use a PAT, the MCP server will have access to the scopes granted by the PAT, which is also subject to any PAT restrictions configured by the organization.
Note
If you are an Enterprise Managed User, then PAT is disabled by default, unless enabled by an enterprise administrator. If PAT is disabled, you won't be able to use PAT authentication. If you have OAuth access policy restrictions, you will need the OAuth App for each client (MCP host application) to be enabled (except Visual Studio Code and Visual Studio).
For information on setting up the GitHub MCP server locally, see theGitHub MCP server repository.
Remote MCP server configuration with OAuth
You do not need to create a PAT or install any additional software to use the remote GitHub MCP server with OAuth. You can set it up directly in Eclipse.
Click the Copilot icon () in the status bar at the bottom of Eclipse.
From the menu, selectOpen Chat and, in the chat window, click the "Configure Tools..." icon.
- Alternatively, you can selectEdit preferences, then in the left pane, expand GitHub Copilot and clickMCP.
Add the following configuration under "Server Configurations":
JSON { "servers": { "github": { "type": "http", "url": "https://api.githubcopilot.com/mcp/" } }}{"servers":{"github":{"type":"http","url":"https://api.githubcopilot.com/mcp/"}}}ClickApply.
In the "GitHub Copilot" popup that says the "MCP Server Definition wants to authenticate to GitHub", clickOK.
If you have not yet authorized the GitHub Copilot plugin, in the browser popup, clickContinue next to your personal account.
Remote MCP server configuration with PAT
To configure the remote GitHub MCP server with a PAT, ensure you have created a PAT with the necessary scopes for the access you want to grant to the MCP server. For more information, seeManaging your personal access tokens.
- Click the Copilot icon () in the status bar at the bottom of Eclipse.
- From the menu, selectOpen Chat and, in the chat window, click the "Configure Tools..." icon.
- Alternatively, you can selectEdit preferences, then in the left pane, expand GitHub Copilot and clickMCP.
- Add the following configuration under "Server Configurations", replacing
YOUR_GITHUB_PATwith the PAT you created:
{ "servers": { "github": { "url": "https://api.githubcopilot.com/mcp/", "requestInit": { "headers": { "Authorization": "Bearer YOUR_GITHUB_PAT" } } } } }{"servers":{"github":{"url":"https://api.githubcopilot.com/mcp/","requestInit":{"headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}}}}Enterprise configuration
If you are using GitHub Enterprise Server or GitHub Enterprise Cloud with data residency, additional configuration is required. For more information, seeConfiguring the GitHub MCP Server for GitHub Enterprise.
Next steps
- To learn how to use the GitHub MCP server in Visual Studio Code, seeUsing the GitHub MCP Server.
- For information on configuring individual toolsets with read-only or read/write access, seeConfiguring toolsets for the GitHub MCP Server.