---
title: "gcloud MCP Server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/gcloud/
description: "Google's gcloud MCP server, published in the googleapis organisation, lets agents drive Google Cloud through the gcloud CLI in natural language — describing outcomes instead of memorising flags. The monorepo hosts three further Google Cloud servers (observability, storage, backupdr) under the same Apache-2.0 licence, runs over stdio via npx, and requires Node.js 20+ and an authenticated gcloud CLI. The repository states it is in preview and not an officially supported Google product."
---

# gcloud MCP Server: review, setup & limitations · Undominated.ai

> Google's gcloud MCP server, published in the googleapis organisation, lets agents drive Google Cloud through the gcloud CLI in natural language — describing outcomes instead of memorising flags. The monorepo hosts three further Google Cloud servers (observability, storage, backupdr) under the same Apache-2.0 licence, runs over stdio via npx, and requires Node.js 20+ and an authenticated gcloud CLI. The repository states it is in preview and not an officially supported Google product.

[← Explore all mcp servers](/mcp-servers/)

CLOUD OPERATIONS / Google

# gcloud MCP Server

Google's gcloud MCP server, published in the googleapis organisation, lets agents drive Google Cloud through the gcloud CLI in natural language — describing outcomes instead of memorising flags. The monorepo hosts three further Google Cloud servers (observability, storage, backupdr) under the same Apache-2.0 licence, runs over stdio via npx, and requires Node.js 20+ and an authenticated gcloud CLI. The repository states it is in preview and not an officially supported Google product.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/googleapis/gcloud-mcp)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 3 linked sources
 Publisher Google
 Licence [Apache-2.0 ↗](https://github.com/googleapis/gcloud-mcp/blob/238728f237ecb5f483199906b564a1767a0713f9/LICENSE)
 Revision 238728f237ec
 [Read what was—and wasn’t—checked ↓](#review)

“The gcloud Model Context Protocol (MCP) server enables AI assistants to easily interact with the Google Cloud environment using the gcloud CLI.”

 [Google · upstream description ↗](https://github.com/googleapis/gcloud-mcp/blob/238728f237ecb5f483199906b564a1767a0713f9/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - googleapis/gcloud-mcp completes the big-three cloud coverage alongside the catalogue's existing Azure and AWS records, published under Google's official API-tooling organisation.
- The server wraps the gcloud CLI rather than raw REST, so it inherits the CLI's credential handling, and the monorepo hosts three further Google Cloud servers — observability, storage and backupdr — under the same Apache-2.0 licence.

### A good fit for

 - Driving Google Cloud operations in natural language through the same gcloud CLI the operator already authenticates with.
- Querying logs, metrics and traces or managing Cloud Storage buckets through the sibling servers in the same monorepo.

### Weigh up before choosing

 - The repository's Important Notes state it is in preview, may see breaking changes, and provides a solution rather than an officially supported Google product not covered under Google Cloud Terms of Service.
- Requires Node.js 20 or higher and the gcloud CLI installed and authenticated; it is a local stdio server, not a hosted remote endpoint.
- run_gcloud_command runs any gcloud command outside its deny list, so creates, updates and deletes are bounded only by the IAM roles of the active gcloud account.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - README at pinned revision 238728f237ecb5f483199906b564a1767a0713f9: the server enables AI assistants to interact with the Google Cloud environment using the gcloud CLI; the monorepo hosts gcloud, observability, storage and backupdr MCP servers published as @google-cloud/* npm packages; prerequisites are Node.js 20+ and the gcloud CLI; setup via `npx @google-cloud/[PACKAGE_NAME] init --agent=gemini-cli` or a standard stdio config; a connection receipt shows `npx -y @google-cloud/gcloud-mcp (stdio) - Connected`; Important Notes state the repository is in preview, may see breaking changes, and provides a solution, not an officially supported Google product, not covered under Google Cloud Terms of Service.
- packages/gcloud-mcp/package.json at the same revision: name @google-cloud/gcloud-mcp, version 0.5.3, Apache-2.0 licence, bin gcloud-mcp -> ./dist/bundle.js; packages/gcloud-mcp/src/index.ts exists at the revision; LICENSE at the revision is Apache 2.0.
- packages/gcloud-mcp/src/index.ts at the same revision: default deny list, --config allow or deny file, single run_gcloud_command registration, stdio transport.

### Our findings

 - The gcloud server is one of four Google Cloud MCP servers in the monorepo, each installable separately via npm.
- Authentication is delegated to the local gcloud CLI session rather than a separate MCP credential.
- The README’s tool table lists one gcloud tool, run_gcloud_command, which executes a gcloud command. packages/gcloud-mcp/src/index.ts registers only that tool and connects a StdioServerTransport.
- index.ts denies these commands by default: compute start-iap-tunnel, compute connect-to-serial-port, compute tpus tpu-vm ssh, compute tpus queued-resources ssh, compute ssh, cloud-shell ssh, workstations ssh, app instances ssh, interactive, meta. A --config JSON file at an absolute path adds an allow list or a deny list, and the server exits if both are given.
- Correction, 2026-10-13: the README prints the client entry as a bare "gcloud" fragment. configExample now holds that fragment as printed; the earlier value wrapped it in an mcpServers object the README does not show.

### Not established by this review

 - The package was not installed and no Google Cloud project was connected.
- run_gcloud_command and the --config allow and deny lists were not exercised.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/googleapis/gcloud-mcp/blob/238728f237ecb5f483199906b564a1767a0713f9/README.md)
 - Install Node.js 20 or higher and the gcloud CLI, and authenticate with `gcloud auth login`.
- Add the configExample to the MCP client, or run `npx @google-cloud/gcloud-mcp init --agent=gemini-cli` for Gemini CLI or Gemini Code Assist.
- Ask the agent to describe a Google Cloud resource to verify the connection.

### Before you start

 - Node.js version 20 or higher.
- The gcloud CLI installed and authenticated against the target project.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 "gcloud": {
 "command": "npx",
 "args": ["-y", "@google-cloud/gcloud-mcp"]
} Copy configuration ↗

### Compatibility

Gemini CLI and Gemini Code Assist via `npx @google-cloud/gcloud-mcp init --agent=gemini-cli`. · Any stdio MCP client via `npx -y @google-cloud/gcloud-mcp`.

### Implementation

TypeScript

### Transports

stdio

### Local gcloud CLI credentials

 - The server acts with the credentials of the authenticated gcloud CLI session.
- Operations are bounded by the IAM roles of that session.
- run_gcloud_command executes gcloud commands. The default deny list blocks only ssh, tunnel, serial-port, interactive and meta commands.

### Cost model

No separate MCP charge is documented; Google Cloud resources the agent creates or changes bill the project.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [gcloud MCP Server README at pinned revision ↗](https://github.com/googleapis/gcloud-mcp/blob/238728f237ecb5f483199906b564a1767a0713f9/README.md) Checked 2026-10-13 https://github.com/googleapis/gcloud-mcp/blob/238728f237ecb5f483199906b564a1767a0713f9/README.md Supports: summary, upstreamDescription, descriptionSourceUrl, install, configExample, compatibility, limitations, transports, whySelected, access, Tool run_gcloud_command
- [gcloud MCP Server package manifest at pinned revision ↗](https://github.com/googleapis/gcloud-mcp/blob/238728f237ecb5f483199906b564a1767a0713f9/packages/gcloud-mcp/package.json) Checked 2026-10-07 https://github.com/googleapis/gcloud-mcp/blob/238728f237ecb5f483199906b564a1767a0713f9/packages/gcloud-mcp/package.json Supports: repository, revision, language, license
- [gcloud MCP entry point: packages/gcloud-mcp/src/index.ts ↗](https://github.com/googleapis/gcloud-mcp/blob/238728f237ecb5f483199906b564a1767a0713f9/packages/gcloud-mcp/src/index.ts) Checked 2026-10-13 https://github.com/googleapis/gcloud-mcp/blob/238728f237ecb5f483199906b564a1767a0713f9/packages/gcloud-mcp/src/index.ts Supports: Default deny list, --config allow or deny file, run_gcloud_command registration, transports, limitations, access

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Cloud Run MCP Server ↗ Inspects Cloud Run services and deploys reviewed source directories or supplied file contents to an authorized project.](/mcp-servers/googlecloudplatform-cloud-run-mcp/)[### Fastly MCP Server ↗ Fastly's official TypeScript MCP server giving agents access to the Fastly API: look up services, domains and TLS settings, check traffic and usage, manage dictionaries and ACLs, purge content and make configuration changes. Tier 1 open-source support, stdio and HTTP transports.](/mcp-servers/fastly/)[### Fly.io flyctl MCP ↗ Manage Fly apps, Machines, volumes, secrets and operational status through the MCP server built into flyctl.](/mcp-servers/fly/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
