Google Cloud MCP

v1.0.0Cloud Servicesstable

Enables interaction with Google Kubernetes Engine (GKE) to list clusters, manage node pools, and retrieve server configurations. It includes automated scripts for deploying and testing sample applications across multiple GKE Autopilot clusters.

gcpgooglegoogle-cloudgoogle-cloud-platformiam
Share:
78
Stars
0
Downloads
0
Weekly
0/5

What is Google Cloud MCP?

Google Cloud MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables interaction with google kubernetes engine (gke) to list clusters, manage node pools, and retrieve server configurations. it includes automated scripts for deploying and testing sample applicat...

Enables interaction with Google Kubernetes Engine (GKE) to list clusters, manage node pools, and retrieve server configurations. It includes automated scripts for deploying and testing sample applications across multiple GKE Autopilot clusters.

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables interaction with Google Kubernetes Engine (GKE) to l

Use Cases

Google Kubernetes Engine management
GCP cluster and node pool control
Cloud deployment automation
krzko

Maintainer

LicenseApache 2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 12, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx google-cloud-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Google Cloud MCP

The Google Cloud MCP Server connects AI assistants to eight core Google Cloud Platform services — Billing, Error Reporting, IAM, Logging, Monitoring, Profiler, Spanner, and Trace — through a single MCP interface. It lets you query logs with filters, analyze cost anomalies, test IAM permissions, retrieve distributed traces, and profile application performance all via natural language. Developers and platform engineers use it to reduce context-switching between the GCP console and their AI assistant during incident response, cost reviews, and routine operations.

Prerequisites

  • Node.js 18+ and pnpm installed on your machine
  • A Google Cloud project with the relevant APIs enabled (Cloud Logging, Monitoring, Billing, IAM, etc.)
  • Google Cloud credentials: either run `gcloud auth application-default login` or have a service account key JSON file
  • The google-cloud-mcp repository cloned locally (no published npm package)
  • An MCP-compatible client such as Claude Desktop
1

Clone and install dependencies

Clone the repository from GitHub and install all Node.js dependencies using pnpm. The project uses pnpm workspaces, so do not substitute npm or yarn.

git clone https://github.com/krzko/google-cloud-mcp.git
cd google-cloud-mcp
pnpm install
2

Authenticate with Google Cloud

The server needs valid Google Cloud credentials at runtime. The simplest approach is Application Default Credentials via the gcloud CLI. Alternatively, create a service account, download the JSON key, and set GOOGLE_APPLICATION_CREDENTIALS.

gcloud auth application-default login
3

Build the TypeScript project

Compile the TypeScript source to JavaScript. The output is written to the dist/ directory and the entry point used by the MCP config is dist/index.js.

pnpm build
4

Configure your MCP client

Add the server to your MCP client configuration file (e.g., claude_desktop_config.json for Claude Desktop). Use the absolute path to the compiled dist/index.js and set the GOOGLE_APPLICATION_CREDENTIALS environment variable if you are using a service account key file.

{
  "mcpServers": {
    "google-cloud-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/google-cloud-mcp/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account-key.json"
      }
    }
  }
}
5

Restart your MCP client and verify connection

Restart Claude Desktop (or your MCP client). The google-cloud-mcp server should appear as connected. You can test it by asking a simple question referencing a real GCP project ID.

Google Cloud MCP Examples

Client configuration

Minimal claude_desktop_config.json entry using Application Default Credentials (no explicit GOOGLE_APPLICATION_CREDENTIALS needed if gcloud auth application-default login was run).

{
  "mcpServers": {
    "google-cloud-mcp": {
      "command": "node",
      "args": ["/Users/you/code/google-cloud-mcp/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/Users/you/.config/gcloud/application_default_credentials.json"
      }
    }
  }
}

Prompts to try

Example natural-language prompts that exercise the server's GCP capabilities.

- "Analyse costs for project my-app-prod-123 for the last 30 days and highlight anomalies"
- "Show me error groups from project my-webapp-prod-789 for the last hour"
- "Test if the service account has storage.buckets.create permission on project data-lake-456"
- "Find logs containing 'database timeout' from project backend-prod-321 from yesterday"
- "Retrieve distributed traces for service checkout-api in project ecom-prod-001 from the last 15 minutes"

Troubleshooting Google Cloud MCP

Server starts but returns 'permission denied' or 403 errors when querying GCP

Ensure the authenticated principal (user or service account) has the required IAM roles such as roles/logging.viewer, roles/monitoring.viewer, and roles/billing.viewer. Run `gcloud auth application-default login` again if credentials have expired.

'Cannot find module dist/index.js' error when the MCP client starts the server

You must run `pnpm build` before starting the server. The TypeScript source must be compiled first. Check that the path in your config points to the correct absolute location of the dist/index.js file.

GOOGLE_CLOUD_PROJECT environment variable errors when operations require a project ID

Either pass the project ID explicitly in each prompt (e.g., 'for project my-proj-123') or set the GOOGLE_CLOUD_PROJECT environment variable in your MCP server config's env block.

Frequently Asked Questions about Google Cloud MCP

What is Google Cloud MCP?

Google Cloud MCP is a Model Context Protocol (MCP) server that enables interaction with google kubernetes engine (gke) to list clusters, manage node pools, and retrieve server configurations. it includes automated scripts for deploying and testing sample applications across multiple gke autopilot clusters. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Google Cloud MCP?

Follow the installation instructions on the Google Cloud MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Google Cloud MCP?

Google Cloud MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Google Cloud MCP free to use?

Yes, Google Cloud MCP is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Google Cloud MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides