Skip to content

027-docs-cli-tutorials.md

Latest commit

 

History

History
87 lines (62 loc) · 3.36 KB

027-docs-cli-tutorials.md

File metadata and controls

87 lines (62 loc) · 3.36 KB
Raw
title Tutorials
url https://geminicli.com/docs/cli/tutorials
source crawler
fetched_at 2026-01-13 19:15:31 -0300
rendered_js false
word_count 308
summary This document guides users through setting up a Model Context Protocol (MCP) server, using the GitHub MCP server as an example, to enable Gemini CLI to interact with GitHub repositories.
tags
gemini-cli
mcp-server
github-integration
docker
configuration
category tutorial

This page contains tutorials for interacting with Gemini CLI.

Setting up a Model Context Protocol (MCP) server

Section titled “Setting up a Model Context Protocol (MCP) server”

[!CAUTION] Before using a third-party MCP server, ensure you trust its source and understand the tools it provides. Your use of third-party servers is at your own risk.

This tutorial demonstrates how to set up an MCP server, using the GitHub MCP server as an example. The GitHub MCP server provides tools for interacting with GitHub repositories, such as creating issues and commenting on pull requests.

Before you begin, ensure you have the following installed and configured:

  • Docker: Install and run Docker.
  • GitHub Personal Access Token (PAT): Create a new classic or fine-grained PAT with the necessary scopes.

Configure the MCP server in settings.json

Section titled “Configure the MCP server in settings.json”

In your project’s root directory, create or open the .gemini/settings.json file. Within the file, add the mcpServers configuration block, which provides instructions for how to launch the GitHub MCP server.


{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
}
}
}
}

Set your GitHub token

Section titled “Set your GitHub token”

[!CAUTION] Using a broadly scoped personal access token that has access to personal and private repositories can lead to information from the private repository being leaked into the public repository. We recommend using a fine-grained access token that doesn’t share access to both public and private repositories.

Use an environment variable to store your GitHub PAT:


GITHUB_PERSONAL_ACCESS_TOKEN="pat_YourActualGitHubTokenHere"

Gemini CLI uses this value in the mcpServers configuration that you defined in the settings.json file.

Launch Gemini CLI and verify the connection

Section titled “Launch Gemini CLI and verify the connection”

When you launch Gemini CLI, it automatically reads your configuration and launches the GitHub MCP server in the background. You can then use natural language prompts to ask Gemini CLI to perform GitHub actions. For example:


"get all open issues assigned to me in the 'foo/bar' repo and prioritize them"