google-cloud-mcp

Overview

The Google Cloud MCP server offers extensive integration with Google Cloud Platform services through the Model Context Protocol. It provides specialized tools for billing analysis, error monitoring, IAM management, logging queries, Spanner database operations, metrics monitoring, performance profiling, and distributed tracing. The server supports both service account key file and environment variable authentication methods, making it flexible for various deployment scenarios. With clear documentation and numerous examples provided, users can easily connect to their GCP resources through natural language prompts.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• gcp-billing-list-accounts

  List all Google Cloud billing accounts

  Try:Show me all my billing accounts
• gcp-billing-analyse-costs

  Analyze costs for a specific Google Cloud project

  Try:Analyse costs for project my-app-prod-123 for the last 30 days
• gcp-error-reporting-list-groups

  List error groups from Google Cloud Error Reporting

  Try:Show me error groups from project my-webapp-prod-789 for the last hour
• gcp-iam-get-project-policy

  Get IAM policy for a Google Cloud project

  Try:Get IAM policy for project my-webapp-prod-123
• gcp-logging-query-logs

  Query and filter log entries from Google Cloud Logging

  Try:Show me logs from project my-app-prod-123 from the last hour with severity ERROR
• gcp-spanner-execute-query

  Execute SQL queries on Google Cloud Spanner databases

  Try:Execute SQL: SELECT COUNT(*) FROM users in database user-db in project my-app-456
• gcp-monitoring-query-metrics

  Retrieve and analyze metrics from Google Cloud Monitoring

  Try:Show me CPU utilisation metrics for project web-app-prod-123 for the last 6 hours
• gcp-profiler-list-profiles

  List CPU and heap profiles from Google Cloud Profiler

  Try:List CPU profiles from project my-java-app-123 for the last 24 hours
• gcp-trace-get-trace

  Get details of a specific trace from Google Cloud Trace

  Try:Get trace details for ID abc123def456 in project distributed-app-789
• gcp-billing-cost-recommendations

  Generate cost optimization recommendations for Google Cloud billing

  Try:Generate cost recommendations for billing account billingAccounts/123456-789ABC-DEF012
• gcp-iam-test-project-permissions

  Test specific permissions for a Google Cloud project

  Try:Test if I have storage.buckets.create permission on project data-lake-456
• gcp-monitoring-query-natural-language

  Query Google Cloud Monitoring using natural language

  Try:Query memory usage for instances in project backend-services-789

Comparable tools

Installation

# Clone and install the repository
git clone https://github.com/krzko/google-cloud-mcp.git
cd google-cloud-mcp
pnpm install
pnpm build

# Authenticate to Google Cloud
gcloud auth application-default login

# Configure in Claude Desktop
{
  "mcpServers": {
    "google-cloud-mcp": {
      "command": "node",
      "args": ["/path/to/google-cloud-mcp/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

FAQ

What authentication methods are supported?

The server supports service account key files (recommended) via GOOGLE_APPLICATION_CREDENTIALS environment variable, or direct environment variables GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY.

How do I troubleshoot timeout issues?

Enable debug logging with 'debug: true' in configuration, set 'lazyAuth: true' to defer authentication until needed, ensure credentials are accessible, and check logs for error messages.

Compare google-cloud-mcp with