GitHub MCP connector
This page covers setting up the GitHub MCP connector. The GitHub MCP connector relies on the general MCP connectors features - refer to that page for an overview of how MCP connectors work.
The GitHub MCP server uses manual OAuth client registration, which means you need to create a GitHub OAuth app before configuring the connector in Port.
Setup steps
1. Create a GitHub OAuth app
In your GitHub organization settings, create a new OAuth app with the following fields:
- Application name: Any recognizable name, e.g.
Port MCP Connector. - Homepage URL:
https://app.port.io - Authorization callback URL (EU region):
https://api.port.io/v1/mcp/oauth2/callback
If your Port organization is on the US region, use https://api.us.port.io/v1/mcp/oauth2/callback as the callback URL instead.
After registering the app, copy the Client ID and generate a Client Secret (copy it immediately - it is only shown once).
For more information on creating a GitHub OAuth app, see the GitHub documentation.
2. Configure the connector in Port
In Port, open the GitHub MCP connector (go to Data Sources > MCP Servers > GitHub), expand Advanced OAuth Settings, and fill in:
- OAuth Client ID: The client ID from step 1.
- OAuth Client Secret: The client secret from step 1.
- OAuth Scope:
repo,read:org(minimum required scope).
Save and publish the connector.
3. Authenticate and use
Follow the standard MCP connector authentication steps. Users will be redirected through the GitHub OAuth flow when they first connect.