Connect GitHub MCP (remote) to Gemini CLI
GitHub's hosted MCP server. Agents read code, issues and pull requests and open PRs with nothing to run on your machine, connecting with a personal access token.
MCP serverOfficialChecked 2026-11-16
Before you start
- Gemini CLI installed (see its MCP documentation (opens in a new tab)).
- GitHub MCP (remote) is available on macOS, Windows, Linux and the web.
- Create a fine-grained personal access token with only the repositories and permissions you need, and set it as
GITHUB_PERSONAL_ACCESS_TOKENin your environment. For read-only tools, end the URL with/readonly. GitHub Enterprise Server doesn't support the hosted server.
Step 1: Add GitHub MCP (remote) to Gemini CLI
Add it from the terminal
Run this in your project folder. It saves the server to the project's
.gemini/settings.json.Terminal gemini mcp add --transport http --header 'Authorization: Bearer ${GITHUB_PERSONAL_ACCESS_TOKEN}' github-remote https://api.githubcopilot.com/mcp/Or edit the config file
Add this to
.gemini/settings.jsonin your project, or to~/.gemini/settings.jsonto use it in every project..gemini/settings.json { "mcpServers": { "github-remote": { "httpUrl": "https://api.githubcopilot.com/mcp/", "headers": { "Authorization": "Bearer ${GITHUB_PERSONAL_ACCESS_TOKEN}" } } } }Good to know- Gemini CLI reads
GITHUB_PERSONAL_ACCESS_TOKENfrom your environment when it loads its settings, so the token stays out of the file.
- Gemini CLI reads
Step 2: Check it's connected
Terminal gemini mcp listIn a Gemini CLI session, run
/mcpto see each server, its status and its tools.Step 3: Try a first request
Ask Gemini CLI something that only works with GitHub MCP (remote) connected:
Say to Gemini CLI List the open issues in this repository that mention design and group them by label.
If it doesn't work
- Since June 2026, Gemini CLI works with a paid Gemini API key or an enterprise licence. If you signed in with a personal Google account, use Google Antigravity instead.
gemini mcp addsaves to the project's.gemini/settings.jsonby default. Add--scope userto save it to~/.gemini/settings.jsonfor every project.- Local servers only show as connected in folders you trust. Run
gemini trustin the project folder. - Gemini CLI hides environment variables that look like secrets from servers unless the server's
envblock lists them.






