Model Context Protocol (MCP) Server for interacting with GCP APIs
npm install @google-cloud/gcloud-mcp
The gcloud
Model Context Protocol (MCP)
server enables AI assistants to easily interact with the Google Cloud
environment using the gcloud CLI. With the gcloud MCP server you can:
- Interact with Google Cloud using natural language. Describe the outcome
you want instead of memorizing complex command syntax, flags, and arguments.
- Automate and simplify complex workflows. Chain multiple cloud operations
into a single, repeatable command to reduce manual effort and the chance of
error.
- Lower the barrier to entry for cloud management. Empower team members who
are less familiar with gcloud to perform powerful actions confidently and
safely.
- Node.js:
version 20 or higher
- gcloud CLI
To integrate MCP servers with Gemini CLI or Gemini Code Assist, run the setup
command below from your home directory for MCP server listed in the table. This
will install the MCP server as a
Gemini CLI extension.
for the current user, making it available for all your projects.
``shell`
npx @google-cloud/gcloud-mcp init --agent=gemini-cli
After the initialization process, you can verify that the gcloud-mcp server is
configured correctly by running the following command:
`
gemini mcp list
> ✓ gcloud: npx -y @google-cloud/gcloud-mcp (stdio) - Connected
`
The gcloud MCP server also allows for allowlisting/denylisting commands. For more information, see the denylist documentation.
To use the gcloud-mcp server with other clients, add the following snippet
to their respective JSON configuration files for each MCP server:
`json`
"gcloud": {
"command": "npx",
"args": ["-y", "@google-cloud/gcloud-mcp"]
}
Instructions for popular tools:
- Claude Desktop: Open Claude > Settings > Developer > Edit Config and
edit claude_desktop_config.json.cline_mcp_settings.json
- Cline: Click the MCP Servers icon, then Configure MCP Servers to edit
..cursor/mcp.json
- Cursor: Edit for a single project or~/.cursor/mcp.json
for all projects..gemini/settings.json
- Gemini CLI (Manual Setup): If not using extensions,
edit for a single project or ~/.gemini/settings.json for
all projects.
For Visual Studio Code edit the .vscode/mcp.json file in your workspace
for a single project or your global user settings file for all projects:
`json`
"servers": {
"gcloud": {
"command": "npx",
"args": ["-y", "@google-cloud/gcloud-mcp"]
}
}
For more information regarding installing the repository locally, please see
development.md
| Tool | Description |
| :------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------- |
| run_gcloud_command` | Executes a gcloud command. Some commands have been restricted from execution by the agent. See MCP Permissions for more information. |
The permissions of the gcloud MCP are directly tied to the permissions of the active
gcloud account. To restrict permissions and operate with the principle of least
privilege, you can
authorize as a service account using impersonation and
assign the service account a
role with limited permissions.
By default, the gcloud MCP prevents execution of gcloud commands that don't
make sense for AI agents. This is done to restrict commands that can run
arbitrary inputs and initiate interactive sessions. See
here
for the list of denied commands.
Google Cloud offers these other servers:
- Firebase MCP
- Google Analytics MCP
- Google Cloud Genmedia MCP
- Google Cloud Run MCP
- Google Kubernetes Engine (GKE) MCP
- Google Security Operations and Threat Intelligence MCP
- MCP Toolbox for Databases
We welcome contributions! Whether you're fixing bugs, sharing feedback, or
improving documentation, your contributions are welcome. Please read our
Contributing Guide to get started.
This repository is currently in preview and may see breaking changes. This
repository provides a solution, not an officially supported Google product. It
is not covered under Google Cloud Terms of Service.
It may break when the MCP specification, other SDKs, or when other solutions
and products change. See also our Security Policy.