Skip to content

MCP server

Google Cloud MCP server

Google's gcloud MCP servers let AI run gcloud commands, read logs, metrics, alerts and traces, and work with Cloud Storage.

At a glance

Maintained by
Google (googleapis GitHub org)
Tools exposed
9 listed below
Reviewed
September 24, 2026

Why it matters

What it does and why it matters

Google publishes a set of MCP servers for Google Cloud in its googleapis organization. The main one runs gcloud commands, which covers most Google Cloud services. Related servers in the same repository read logs, metrics, alert policies and traces, and list, read and write Cloud Storage objects.

For teams on Google Cloud, that means one assistant can check a service, read its logs and look at related metrics in one conversation.

The repository states that it is not an officially supported Google product, even though it is published by Google. Treat it with the same care as a community tool. The gcloud tool can change most resources your account can touch, so use a service account with narrow roles and keep production changes behind review.

Use cases

Best business use cases

Log questions

Read log entries for an error.

Metrics

Check CPU, memory or request metrics.

Alerts

List alert policies and their state.

Storage

List and read Cloud Storage objects.

gcloud help

Run and explain gcloud commands.

Tools

Available tools

Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.

Main server is gcloud, which has one tool. Other tools come from the observability and storage servers in the same repo; each is installed as its own package.

Read and write: Read and write: gcloud can change most resources your account can touch; observability tools are read-only; storage tools read and write.

  • run_gcloud_command

    gcloud server. Run a gcloud CLI command; unsafe or interactive commands are blocked.

  • list_log_entries

    observability server. List log entries for a project.

  • list_time_series

    observability server. List time series data for a metric.

  • list_alert_policies

    observability server. List alert policies in a project.

  • list_traces

    observability server. Search traces in a project.

  • list_objects

    storage server. List objects in a Cloud Storage bucket.

  • read_object_content

    storage server. Read the content of an object.

  • write_object

    storage server. Write a new object to a bucket.

  • create_bucket

    storage server. Create a new bucket.

Workflows

Example workflows

Trace an error

  1. 1

    Describe the error.

  2. 2

    The assistant reads recent log entries.

  3. 3

    It checks related traces.

  4. 4

    It explains the likely cause.

  5. 5

    An engineer applies the fix.

Review alerting

  1. 1

    Ask for alert policies.

  2. 2

    The assistant lists them.

  3. 3

    It notes services without alerts.

  4. 4

    It suggests new alerts.

  5. 5

    The team decides which to add.

Prompts

Example prompts

  • “Show error logs for the checkout service in the last hour.”

  • “Which services have no alert policy?”

  • “List objects uploaded to the exports bucket today.”

Setup

Installation and configuration

Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.

Claude Desktop: claude_desktop_config.json

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

Claude Code: terminal

claude mcp add gcloud -- npx -y @google-cloud/gcloud-mcp
  • Local server: npm: @google-cloud/gcloud-mcp (stdio). Same repo also ships @google-cloud/observability-mcp, @google-cloud/storage-mcp and @google-cloud/backupdr-mcp..
  • Needs: Uses the active gcloud CLI account (gcloud auth login). Service account impersonation supported. Node.js 20+ required..

Security

Security considerations

  • Read-only first

    Start with read access and add actions only for reviewed tasks.

  • Scoped credentials

    Use a dedicated role or token with the least access, never an owner or admin key.

  • Separate environments

    Keep production changes out of assistant sessions, or require approval for them.

  • Audit

    Use Cloud Audit Logs to review actions.

Related servers

Servers that pair well with it

BigQuery

Google's remote BigQuery MCP server lets AI list datasets and tables and run SQL, with a read-only query tool and IAM controls.

AWS

The AWS API MCP server from AWS Labs lets AI run AWS CLI commands, suggest commands and plan changes, with read-only and consent modes.

Azure

Microsoft's Azure MCP server lets AI work with many Azure services, from storage and Key Vault to SQL, monitoring and AKS, with a read-only mode.

Keep exploring

FAQ

Questions people ask us

Have a question that is not here? Ask us directly.

Start a project

Want this connected to your own systems? We build AI workflows with MCP.

Send a short brief. We reply with questions, a suggested plan and an estimate you can compare with other offers.

Your privacy choices

We use necessary storage to run this site. With your permission we also use Google Analytics to see which pages help people, and load maps from Google. You can change this at any time. Read the cookie policy.