Best for
- Developers who work primarily in the command line
- Individual developers and teams needing code understanding, generation, and automation
- Users who want to connect custom MCP tools to Gemini CLI
G
58FMRS · C
Based on the supplied README, Gemini CLI is an Apache-2.0 open-source terminal AI agent with MCP client extensibility. The source does not provide evidence for a standalone MCP server manifest, transport, tool list, or client compatibility.
Gemini CLI is an open-source AI agent that brings Gemini directly into the terminal. It supports code understanding and generation, file operations, shell commands, web fetching, Google Search grounding, and MCP-based custom integrations. The repository documents a terminal AI agent with MCP client capabilities; the source does not establish that it exposes a standalone MCP server or a tool catalog.
Tools
The tool list has not been reviewed yet.
Setup
Run npx @google/gemini-cli for an instant launch. Alternatively, install with npm install -g @google/gemini-cli, or use brew install gemini-cli on macOS/Linux. Start it with gemini. Authentication supports Google account sign-in, GEMINI_API_KEY, or Vertex AI environment configuration.
Fit and risk
Not for
- Users looking for a documented MCP tool catalog
- Users needing a standalone MCP server to deploy and connect directly
- Environments that do not permit terminal, file, or shell capabilities
Required permissions
- Gemini authentication through a Google account, Gemini API key, or Vertex AI configuration
- File and shell access when the corresponding built-in tools are used
- Network access for Google Search grounding and web fetching
- GOOGLE_CLOUD_PROJECT may be required for paid organizational Code Assist licenses
Risks and side effects
- File operations and shell commands can affect the project or runtime environment; sandboxing and trusted-folder controls should be reviewed
- Preview and nightly channels may contain regressions or outstanding issues
- API keys, Google accounts, and cloud project configuration require protection
Troubleshooting
- Verify Google sign-in or the relevant GEMINI_API_KEY, GOOGLE_API_KEY, and GOOGLE_GENAI_USE_VERTEXAI settings
- For a paid Code Assist license, verify GOOGLE_CLOUD_PROJECT is set
- Check the release channel; use latest when a stable release is required
- MCP server configuration is documented at ~/.gemini/settings.json
- Consult the troubleshooting guide or use the /bug command
Use cases
Analyzing and editing large codebases from the terminal
Debugging and troubleshooting with natural language
Automating tasks through scripts or GitHub workflows
Adding custom capabilities by configuring MCP servers
Supported clients
Supported clients have not been confirmed yet.