docs: Add Google Gemini CLI installation guide and integration #757

ipapapa · 2025-07-26T17:46:19Z

Add installation guide for Google Gemini CLI
Include Docker and binary configuration options
Add authentication setup for Gemini API and Vertex AI
Update main README.md to include Gemini CLI in installation guides
Update installation guides index with Gemini CLI entry and support matrix
Follow established documentation patterns and security best practices

Closes:
#756

- Add comprehensive installation guide for Google Gemini CLI - Include Docker and binary configuration options - Add authentication setup for Gemini API and Vertex AI - Update main README.md to include Gemini CLI in installation guides - Update installation guides index with Gemini CLI entry and support matrix - Follow established documentation patterns and security best practices

soisyourface

This is awesome. For a gemini-cli user that is just trying to get this MCP to work, this is very helpful.

Left a few thoughts on the command use and things.

soisyourface · 2025-08-01T23:56:58Z

docs/installation-guides/install-gemini-cli.md

+# Install GitHub MCP Server in Google Gemini CLI
+
+## Prerequisites
+1. Google Gemini CLI installed (see [Installation Options](#installation-options))


question: should a guide on installing gemini-cli be in here? or just a link to the gemini-cli github page for instructions?

Good question! I've kept a brief installation section for user convenience (just the basic commands for npm, npx, and Homebrew) but added a link to the https://github.com/google-gemini/gemini-cli for more detailed installation options. This way users get the essentials quickly but can dive deeper if needed. What do you think of this approach?

mostly just worried that this information falls behind and perhaps a link to gemini-cli's installation is more robust.

Makes sense, I have made a few changes to emphasize the official documentation link first - making it clear users should go there for up-to-date instructions.

I don't think the information for how to install Gemini CLI belongs here. AFAIK the analogous information is not in the README files for other tools. Eg for Windsurf, the install guide talks about how to install github-mcp-server for Windsurf, not how to install windsurf.

soisyourface · 2025-08-02T00:04:10Z

docs/installation-guides/install-gemini-cli.md

+
+1. **Check MCP server status**:
+   ```bash
+   gemini-cli mcp status


fix: i think the command is gemini and not gemini-cli.

also, there is no gemini mcp status command. the closest is gemini --prompt /mcp list.

for the tools a gemini --prompt /tools

this is true for examples below. you'll need the --prompt flag.

Oups, this was my mistake. I am sorry for this and thank you for catching it. I will fix it below with a new commit.
✅ Changed all gemini-cli commands to gemini
✅ Fixed gemini mcp status to gemini --prompt /mcp list
✅ Fixed gemini mcp list-tools to gemini --prompt /tools
✅ Added --prompt flags where needed throughout the examples

- Replace all 'gemini-cli' commands with correct 'gemini' syntax - Fix verification commands to use '/mcp list' and '/tools' prompts - Add httpUrl remote server method as primary configuration option - Update config file paths from settings.json to config.json - Correct npx installation command syntax - Add link to official Gemini CLI documentation Addresses feedback from soisyourface in PR review.

rica19ro · 2025-08-02T06:33:24Z

Add installation guide for Google Gemini CLI

Include Docker and binary configuration options

Add authentication setup for Gemini API and Vertex AI

Update main README.md to include Gemini CLI in installation guides

Update installation guides index with Gemini CLI entry and support matrix

Follow established documentation patterns and security best practices

Closes:
#756

Reduce detailed installation steps and direct users to official docs for up-to-date instructions, addressing reviewer feedback about maintainability.

DinoChiesa · 2025-08-08T05:27:29Z

docs/installation-guides/install-gemini-cli.md

+
+Gemini CLI uses a settings JSON file to configure MCP servers:
+
+- **Global configuration**: `~/.gemini/config.json`


is it not settings.json ?

Oups my mistake, I have fixed it: a6e2426

DinoChiesa · 2025-08-08T05:28:56Z

docs/installation-guides/install-gemini-cli.md

+## Installation Options
+
+Install Google Gemini CLI using your preferred method. For the most up-to-date installation instructions and troubleshooting, see the [official Gemini CLI documentation](https://github.com/google-gemini/gemini-cli).
+


Probably lines 11 through 41 are best left out of this README., which pertains to github-mcp-server. Install instructions for Germini CLI should remain in the README for Gemini CLI.

Good point about lines 11-41. I removed the Gemini CLI installation and authentication sections to keep this focused on GitHub MCP Server setup. This is also consistent with our other installation guides.

docs/installation-guides/install-gemini-cli.md

DinoChiesa · 2025-08-08T05:30:58Z

docs/installation-guides/install-gemini-cli.md

+
+### Method 2: Local Docker Setup (Alternative)
+
+**Important**: The npm package `@modelcontextprotocol/server-github` is no longer supported as of April 2025. Use the official Docker image `ghcr.io/github/github-mcp-server` instead.


omit "Important: The npm package @modelcontextprotocol/server-github is no longer supported as of April 2025."

This doc page is being added in August 2025. No need to reference old stuff.

Done: 6bfae0d

DinoChiesa · 2025-08-08T05:31:32Z

docs/installation-guides/install-gemini-cli.md

+## Prerequisites
+1. Google Gemini CLI installed (see [Installation Options](#installation-options))
+2. [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new) with appropriate scopes
+3. For local installation: [Docker](https://www.docker.com/) installed and running


Or Podman. (https://podman.io)

I have not used Podman but based on my quick check it has Docker command compatibility, so I have added it: 79e0782

In case there is any doubt.... I use podman with this server and with gemini-cli, and it works great - no surprise here.

docs/installation-guides/install-gemini-cli.md

DinoChiesa · 2025-08-08T05:34:42Z

docs/installation-guides/install-gemini-cli.md

+
+- **Official repository**: [github/github-mcp-server](https://github.com/github/github-mcp-server)
+- **Docker image**: `ghcr.io/github/github-mcp-server` (official and supported)
+- **npm package**: `@modelcontextprotocol/server-github` (deprecated as of April 2025 - no longer functional)


Done, I have removed the deprecated npm package in this commit 6bfae0d

DinoChiesa

Thanks for doing this.
I left a bunch of comments.

The correct configuration file for Gemini CLI is settings.json, not config.json. This applies to both global (~/.gemini/settings.json) and project-specific (.gemini/settings.json) configurations as confirmed by official documentation.

Removed lines 11-41 containing Gemini CLI installation commands and authentication setup instructions.

Added Podman as container engine option alongside Docker.

DinoChiesa · 2025-08-08T16:11:01Z

looking good

Environment variable substitution in headers is not yet supported by Gemini CLI (see google-gemini/gemini-cli#5282).

ipapapa · 2025-08-08T18:00:12Z

@DinoChiesa I have addressed the comments above. Thank you so much for the amazing feedback, it helped a lot. Let me know if there is anything else that you might find useful. Otherwise, feel free to "approve" as a reviewer.

ipapapa · 2025-08-09T09:29:34Z

@soisyourface is there any feedback that has not been addressed? Please let me if you approve for this work to finalize. Thank you!

…s of inactivity (github#909) * update PR_DAYS_BEFORE_STALE * update to mark as stale after 60 days

* Revise Claude installation guide - Verified Claude Code installation steps - Identified and documented issues with Claude Desktop setup - Updated installation documentation based on testing * Revise instructions for opening Claude Code Updated recommendations for opening Claude Code. * Update docs/installation-guides/install-claude.md Co-authored-by: Copilot <[email protected]> * Update docs/installation-guides/install-claude.md Co-authored-by: Copilot <[email protected]> * Update installation guide for Claude setup Added installation option for using Claude Code using a release binary. * Change section title for Go Binary installation Updated section title for clarity regarding installation without Docker. * Close double quote in bash command --------- Co-authored-by: Copilot <[email protected]> Co-authored-by: LuluBeatson <[email protected]> Co-authored-by: Matt Holloway <[email protected]> Co-authored-by: Tommaso Moro <[email protected]>

* add sliding window for actions logs * refactor: fix sliding * remove trim content * only use up to 1mb of memory for logs * update to tail lines in second pass * add better memory usage calculation * increase window size to 5MB * update test * update vers * undo vers change * add incremental memory tracking * use ring buffer * remove unused ctx param * remove manual GC clear * fix cca feedback * extract ring buffer logic to new package * handle log content processing errors and use correct param for maxjobloglines * fix tailing * account for if tailLines exceeds window size * add profiling thats reusable * remove profiler testing * refactor profiler: introduce safeMemoryDelta for accurate memory delta calculations * linter fixes * Update pkg/buffer/buffer.go Co-authored-by: Copilot <[email protected]> * use flag for maxJobLogLines * add param passing for context window size * refactor: rename contextWindowSize to contentWindowSize for consistency * fix: use tailLines if bigger but only if <= 5000 * fix: limit tailLines to a maximum of 500 for log content download * Update cmd/github-mcp-server/main.go Co-authored-by: Adam Holt <[email protected]> * Update cmd/github-mcp-server/main.go Co-authored-by: Adam Holt <[email protected]> * move profiler to internal/ * update actions test with new profiler location * fix: adjust buffer size limits * make line buffer 1028kb * fix mod path * change test to use same buffer size as normal use * improve test for non-sliding window implementation to not count empty lines * make test memory measurement more accurate * remove impossible conditional --------- Co-authored-by: Copilot <[email protected]> Co-authored-by: Adam Holt <[email protected]>

* add get_release_by_tag tool * add tool * add tests * autogen * remove comment

…ndex (github#892) * docs(readme): Update readme to point to correct installation guides index * feat(contributors): add list_repository_contributors tool * Revert "feat(contributors): add list_repository_contributors tool" This reverts commit ece480e. --------- Co-authored-by: Tommaso Moro <[email protected]>

* Add support for listing repo level security advisories * Add support for listing repo security advisories at the org level

* use new link * update local install link

…ingAgentPrompt` and `IssueToFixWorkflowPrompt`. Role "system" is not allowed by Claude Code in MCP provided prompt (allowed only role "user" and "assistant") (github#941) Co-authored-by: 0xGosu <[email protected]>

soisyourface · 2025-08-28T22:27:52Z

upstream in gemini-cli the bug was fixed concerning the .env loading.

LGTM

LuluBeatson · 2025-08-29T17:09:33Z

Thank you @ipapapa for contributing this installation guide :)

I've made a few changes such as:

Re-ordering the sections so "Storing Your PAT Securely" is earlier and in the Prerequisites section (similar to structure of guide for Claude Code CLI)
Keeping the version of configs using $GITHUB_PAT, but removed duplicated configs requiring hardcoded PAT.
Removed additional configs with extra env vars. This info lives elsewhere as it's relevant to many host applications and IDEs. If it is not present, I will follow up to add it.
Fix in summary table to say that Local GitHub MCP is supported in Gemini CLI

rmedranollamas · 2025-08-29T20:59:01Z

docs/installation-guides/install-gemini-cli.md

+            "httpUrl": "https://api.githubcopilot.com/mcp/",
+            "trust": true,
+            "headers": {
+                "Authorization": "Bearer $GITHUB_PAT"


remove "Bearer"

Oups good catch. I fixed it: f2e5ad7

rmedranollamas · 2025-08-29T21:00:18Z

chiming in from #742 here -- i think this one will do (and includes the .env mechanism, which i don't). i am happily closing my PR, so we this one merged in.

saiqulhaq · 2025-08-31T12:38:33Z

docs/installation-guides/install-gemini-cli.md

+
+</details>
+
+## GitHub MCP Server Configuration


The installation could be outdated with the main README.md file
We should inform the user to see the README.md of this project for the latest config

Added the note as requested: 26d9139

…ets (github#988) * add comprehensive minimal response where appropriate * remove unneeded comments * remove incorrect diff param * update docs * rm comment * Update pkg/github/repositories.go Co-authored-by: Lulu <[email protected]> * update toolsnaps and docs * change minimal_output to use new OptionalBoolParamWithDefault * Update pkg/github/repositories.go Co-authored-by: Lulu <[email protected]> * refactor minimal conversion funcs to minimal_types.go * consolidate response structs and remove unneeded message field * consolidate response further * remove CloneURL field * Update pkg/github/repositories.go Co-authored-by: Copilot <[email protected]> * Update pkg/github/server.go Co-authored-by: Copilot <[email protected]> * fix undefined * change incorrect comment * remove old err var declaration * Update pkg/github/repositories.go Co-authored-by: Copilot <[email protected]> * fix syntax issue * update toolsnaps --------- Co-authored-by: Lulu <[email protected]> Co-authored-by: Copilot <[email protected]>

ipapapa requested a review from a team as a code owner July 26, 2025 17:46

ipapapa mentioned this pull request Aug 1, 2025

Add installation guide for Google Gemini CLI #756

Closed

soisyourface reviewed Aug 2, 2025

View reviewed changes

piyanutwat approved these changes Aug 2, 2025

View reviewed changes

ipapapa added 2 commits August 3, 2025 14:04

Merge branch 'main' into add-gemini-cli-docs

526a6c1

Emphasize official Gemini CLI documentation link

0127628

Reduce detailed installation steps and direct users to official docs for up-to-date instructions, addressing reviewer feedback about maintainability.

DinoChiesa reviewed Aug 8, 2025

View reviewed changes

docs/installation-guides/install-gemini-cli.md Outdated Show resolved Hide resolved

DinoChiesa reviewed Aug 8, 2025

View reviewed changes

docs/installation-guides/install-gemini-cli.md Outdated Show resolved Hide resolved

DinoChiesa reviewed Aug 8, 2025

View reviewed changes

DinoChiesa suggested changes Aug 8, 2025

View reviewed changes

ipapapa added 4 commits August 8, 2025 04:32

Remove Gemini CLI installation and authentication sections

bc96391

Removed lines 11-41 containing Gemini CLI installation commands and authentication setup instructions.

Add Podman as Docker alternative in prerequisites

79e0782

Added Podman as container engine option alongside Docker.

Remove references to deprecated npm package

6bfae0d

ipapapa added 2 commits August 8, 2025 10:53

Add comprehensive ~/.gemini/.env file example

c52a1de

Fix authorization header to use literal token placeholder

e5e7bfd

Environment variable substitution in headers is not yet supported by Gemini CLI (see google-gemini/gemini-cli#5282).

DinoChiesa mentioned this pull request Aug 8, 2025

Gemini CLI is not performing environment variable substitution for MCP Servers google-gemini/gemini-cli#5828

Open

DinoChiesa approved these changes Aug 8, 2025

View reviewed changes

tommaso-moro and others added 10 commits August 27, 2025 19:29

Update "Close inactive issues" workflow to close issues after 180 day…

0d4dca9

…s of inactivity (github#909) * update PR_DAYS_BEFORE_STALE * update to mark as stale after 60 days

Add get_release_by_tag tool (github#938)

615cc60

* add get_release_by_tag tool * add tool * add tests * autogen * remove comment

Add Global Security Advisories Toolset (github#919)

cd4454e

Repository security advisories (github#925)

ad3bf32

* Add support for listing repo level security advisories * Add support for listing repo security advisories at the org level

Update Cursor installation link (github#940)

6d4e070

* use new link * update local install link

Resolve merge conflict with latest upstream main

7acaad0

LuluBeatson self-assigned this Aug 29, 2025

LuluBeatson and others added 3 commits August 29, 2025 17:28

Merge branch 'main' into add-gemini-cli-docs

60fa301

Local MCP is supported

39db9e7

Refactor Gemini CLI install guide

ff86293

LuluBeatson mentioned this pull request Aug 29, 2025

Docs/update gemini install guide #742

Closed

rmedranollamas reviewed Aug 29, 2025

View reviewed changes

Remove Bearer from Authorization header

f2e5ad7

saiqulhaq suggested changes Aug 31, 2025

View reviewed changes

Add reference to main README for latest config

26d9139

saiqulhaq approved these changes Aug 31, 2025

View reviewed changes

LuluBeatson and others added 4 commits September 2, 2025 18:41

Bearer needed for headers, add references

f86124e

initial org repo create support (github#1023)

f898f17

Merge branch 'main' into add-gemini-cli-docs

f6718c7

LuluBeatson merged commit c345e9b into github:main Sep 4, 2025
10 checks passed

LuluBeatson linked an issue Sep 4, 2025 that may be closed by this pull request

Add installation guide for Google Gemini CLI #756

Closed

ipapapa deleted the add-gemini-cli-docs branch September 4, 2025 12:28


		Gemini CLI uses a settings JSON file to configure MCP servers:

		- Global configuration: `~/.gemini/config.json`

		## Installation Options

		Install Google Gemini CLI using your preferred method. For the most up-to-date installation instructions and troubleshooting, see the [official Gemini CLI documentation](https://github.com/google-gemini/gemini-cli).


		### Method 2: Local Docker Setup (Alternative)

		Important: The npm package `@modelcontextprotocol/server-github` is no longer supported as of April 2025. Use the official Docker image `ghcr.io/github/github-mcp-server` instead.

docs: Add Google Gemini CLI installation guide and integration #757

docs: Add Google Gemini CLI installation guide and integration #757

Uh oh!

Conversation

ipapapa commented Jul 26, 2025

Uh oh!

soisyourface left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ipapapa Aug 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rica19ro commented Aug 2, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DinoChiesa Aug 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ipapapa Aug 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DinoChiesa left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DinoChiesa commented Aug 8, 2025

Uh oh!

ipapapa commented Aug 8, 2025

Uh oh!

ipapapa commented Aug 9, 2025

Uh oh!

soisyourface commented Aug 28, 2025

Uh oh!

LuluBeatson commented Aug 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ipapapa Aug 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rmedranollamas commented Aug 29, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ipapapa Aug 2, 2025 •

edited

Loading

DinoChiesa Aug 8, 2025 •

edited

Loading

ipapapa Aug 8, 2025 •

edited

Loading

DinoChiesa left a comment •

edited

Loading

LuluBeatson commented Aug 29, 2025 •

edited

Loading

ipapapa Aug 29, 2025 •

edited

Loading