Skip to content
Back to search

mcp-toolbox

Gemini CLI Extension - MCP Toolbox

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gemini-cli-extensions--mcp-toolbox/badge.svg)](/listings/gemini-cli-extensions--mcp-toolbox)

HTML

<a href="/listings/gemini-cli-extensions--mcp-toolbox"><img src="/api/listings/gemini-cli-extensions--mcp-toolbox/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installation

gemini extensions install https://github.com/GoogleCloudPlatform/mcp-toolbox-plugin

Configuration

* Add your [`tools.yaml` configuration file](https://mcp-toolbox.dev/documentation/configuration/) to the directory you are running Gemini CLI.

Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment if connecting to Google Cloud services.

Start Gemini CLI

To start the Gemini CLI, use the following command:

gemini

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 74 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Gemini CLI Extension - MCP Toolbox
  2. > [!NOTE]
  3. > This extension is currently in beta (pre-v1.0), and may see breaking changes until the first stable release (v1.0).
  4. Develop and query your custom tools using the power of natural language, directly
  5. from your command line through [MCP
  6. Toolbox](https://github.com/googleapis/mcp-toolbox). Go from an idea to a
  7. running, invocable tool in minutes, without ever leaving your terminal.
  8. Learn more about [Gemini CLI Extensions](https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md).
  9. > [!IMPORTANT]
  10. > **We Want Your Feedback!**
  11. > Please share your thoughts with us by filling out our feedback [form][form].
  12. > Your input is invaluable and helps us improve the project for everyone.
  13. [form]: https://docs.google.com/forms/d/e/1FAIpQLSfEGmLR46iipyNTgwTmIDJqzkAwDPXxbocpXpUbHXydiN1RTw/viewform?usp=pp_url&entry.157487=mcp-toolbox
  14. ## Why Use the MCP Toolbox Extension?
  15. * **Reliable Custom Servers:** Quickly create a **custom MCP server** with tools designed to reliably return accurate results. This saves significant development time and cost by ensuring your agent gets precise data without extensive guidance or fine-tuning.
  16. * **Enterprise Data Awareness:** Instantly upgrade your developer environment by providing your agents with **enterprise-grade data awareness**. Connect your AI systems directly to your data sources for smarter, more relevant operations.
  17. * **Accelerated Agent Development:** Fast-track your AI project by easily testing and validating tool usage with a **pre-built agent environment**.
  18. ## Prerequisites
  19. Before you begin, ensure you have the following:
  20. * [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed with version **+v0.6.0**.
  21. * Setup Gemini CLI [Authentication](https://github.com/google-gemini/gemini-cli/tree/main?tab=readme-ov-file#-authentication-options).
  22. * Any required APIs and permissions for connecting to your database.
  23. ## Getting Started
  24. ### Installation
  25. ```bash
  26. gemini extensions install https://github.com/GoogleCloudPlatform/mcp-toolbox-plugin
  27. ```
  28. ### Configuration
  29. * Add your [`tools.yaml` configuration file](https://mcp-toolbox.dev/documentation/configuration/) to the directory you
  30. are running Gemini CLI.
  31. Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment if connecting to Google Cloud services.
  32. ### Start Gemini CLI
  33. To start the Gemini CLI, use the following command:
  34. ```bash
  35. gemini
  36. ```
  37. ## Usage
  38. Interact with your custom tools using natural language.
  39. ## Additional Extensions
  40. Find additional extensions to support your entire software development lifecycle at [github.com/gemini-cli-extensions](https://github.com/gemini-cli-extensions), including a generic [PostgreSQL extension](https://github.com/GoogleCloudPlatform/postgres-plugin).
  41. ## Troubleshooting
  42. Use `gemini --debug` to enable debugging.
  43. Common issues:
  44. * "failed to find default credentials: google: could not find default credentials.": Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment. See [Set up Application Default Credentials](https://cloud.google.com/docs/authentication/external/set-up-adc) for more information.
  45. * "✖ Error during discovery for server: MCP error -32000: Connection closed": The database connection has not been established. Ensure your configuration is set via environment variables.
  46. * "✖ MCP ERROR: Error: spawn /Users/USER/.gemini/extensions/mcp-toolbox/toolbox ENOENT": The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+.
  47. * "cannot execute binary file": The Toolbox binary did not download correctly. Ensure the correct binary for your OS/Architecture has been downloaded. See [Installing the server](https://mcp-toolbox.dev/documentation/introduction/#install-toolbox) for more information.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.