Repolode
Submit
googleapis

googleapis/gcloud-mcp

An MCP server that lets AI assistants run gcloud CLI commands and query Google Cloud Observability, Cloud Storage and Backup and DR using natural language.

View on GitHub
Stars
931
Forks
83
Open issues
69
Last commit
5 days ago

What is it?

gcloud MCP is a Model Context Protocol server that connects AI assistants to Google Cloud through the gcloud CLI. Instead of memorizing command syntax, flags and arguments, users describe the outcome they want and the assistant runs the matching gcloud operations.

The repository hosts several servers: gcloud for running gcloud commands, observability for querying logs, metrics, traces and error groups, storage for managing Cloud Storage buckets and objects, and backupdr for working with Backup and Disaster Recovery vaults, plans and backups. Each server is published as an npm package under @google-cloud and can be launched with npx.

Setup targets Gemini CLI and Gemini Code Assist, with manual configuration snippets for Claude Desktop, Cline, Cursor and Visual Studio Code. Requires Node.js 20 or later and the gcloud CLI. Some interactive or arbitrary-input gcloud commands are blocked by default, and access is bounded by the active gcloud account's permissions.

Key features

  • 01Runs gcloud CLI commands from natural language prompts through the run_gcloud_command tool.
  • 02Queries Cloud Logging, Cloud Monitoring metrics, traces and error groups.
  • 03Lists, reads, uploads, downloads, copies and moves Cloud Storage objects.
  • 04Manages buckets, IAM policies and Storage Insights queries.
  • 05Inspects and operates Backup and Disaster Recovery vaults, plans and backups.

Use cases

  • Letting developers who are unfamiliar with gcloud perform common cloud tasks from an AI assistant.
  • Investigating production issues by querying logs, traces and metrics in conversation.
  • Chaining several Cloud Storage or backup operations into one repeatable workflow.
  • Running gcloud commands under a restricted service account via impersonation.

Quick start

  1. 1

    Prerequisites: install Node.js 20 or higher and the gcloud CLI

  2. 2

    Add the gcloud MCP server to your AI client config (for example Claude Desktop, Cline, Cursor or VS Code)

    npx -y @google-cloud/gcloud-mcp
  3. 3

    Or, for Gemini CLI, run the setup command from your home directory

    npx @google-cloud/gcloud-mcp init --agent=gemini-cli

Things to know

  • Requires an installed and configured gcloud CLI and Node.js 20 or higher.
  • Commands run through the agent can act on real Google Cloud resources, so access should be scoped carefully.

Topics

#mcp#google-cloud#gcloud#ai-agent#cloud-storage#observability#backup#cli

FAQ

What is gcloud-mcp?
An MCP server that lets AI assistants run gcloud CLI commands and query Google Cloud Observability, Cloud Storage and Backup and DR using natural language. gcloud MCP is a Model Context Protocol server that connects AI assistants to Google Cloud through the gcloud CLI. Instead of memorizing command syntax, flags and arguments, users describe the outcome they want and the assistant runs the matching gcloud operations.
Is gcloud-mcp free to use? What license does it have?
gcloud-mcp is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is gcloud-mcp still maintained?
Actively maintained. The last commit to gcloud-mcp was on Oct 17, 2026.
What can I use gcloud-mcp for?
Letting developers who are unfamiliar with gcloud perform common cloud tasks from an AI assistant. Investigating production issues by querying logs, traces and metrics in conversation. Chaining several Cloud Storage or backup operations into one repeatable workflow. Running gcloud commands under a restricted service account via impersonation.
How do I install gcloud-mcp?
Prerequisites: install Node.js 20 or higher and the gcloud CLI Add the gcloud MCP server to your AI client config (for example Claude Desktop, Cline, Cursor or VS Code): npx -y @google-cloud/gcloud-mcp Or, for Gemini CLI, run the setup command from your home directory: npx @google-cloud/gcloud-mcp init --agent=gemini-cli
Where can I get gcloud-mcp?
The source code and installation instructions are on GitHub: https://github.com/googleapis/gcloud-mcp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects