google-cloud-support-mcp

An MCP server for Google Cloud Support. Read and act on support cases across every project and organization you have access to, without leaving the conversation.

This is not an official Google product. It is an independent project, not affiliated with, endorsed by, or supported by Google. It talks to the public Cloud Support API using your own credentials. Google Cloud and Google are trademarks of Google LLC.

What it covers

Fifteen tools over the Cloud Support API v2 — cases, comments, attachments, and problem classifications, plus scope discovery:

Plus a case://{parent_type}/{parent_id}/{case_id} resource template and two prompts (triage_open_cases, draft_case_from_incident).

Scopes are named in the conversation, not configured in advance. "List the open cases in my-billing-project" works with nothing set up; list_scopes turns a name you know into the identifier the API wants, which matters most for organizations — they are addressed by a number nobody remembers.

Not covered, deliberately:

• SupportEventSubscriptionService (7 RPCs) — push delivery and subscription CRUD alike.
• v2beta, including FeedService.ShowFeed. The one thing v2beta looked like it offered — cross-organization search — turned out not to exist: its query grammar's OR combines values within a field, never scope identifiers.

Prerequisites

1. Python 3.14+ and uv

2. A paid support plan (Standard, Enhanced, or Premium) on the target project or organization. The Cloud Support API is unavailable without one, and that failure is reported separately from a permissions failure.

3. IAM: roles/cloudsupport.techSupportViewer to read, roles/cloudsupport.techSupportEditor to write. Organization-level scopes also need resourcemanager.organizations.get.

4. For list_scopes only — the Cloud Resource Manager API enabled, plus resourcemanager.projects.get and, to see organizations, resourcemanager.organizations.get. Nothing else needs it, and holding one permission and not the other is fine: the class you cannot read is reported and the other still answers.

   gcloud services enable cloudresourcemanager.googleapis.com --project=PROJECT_ID
   

5. API enabled and credentials resolved:

   gcloud services enable cloudsupport.googleapis.com --project=PROJECT_ID
   gcloud auth application-default login
   gcloud auth application-default set-quota-project PROJECT_ID
   

Install and run

Nothing to clone or install — uvx fetches the published package and runs it:

uvx google-cloud-support-mcp

Register it with an MCP client:

{
  "mcpServers": {
    "google-cloud-support": {
      "command": "uvx",
      "args": ["google-cloud-support-mcp"],
      "env": {
        "GOOGLE_CLOUD_SUPPORT_MCP_PARENTS": "[\"projects/my-project\",\"organizations/123456789\"]",
        "GOOGLE_CLOUD_SUPPORT_MCP_QUOTA_PROJECT": "my-project"
      }
    }
  }
}

Pin a release with uvx google-cloud-support-mcp@0.1.0 if you would rather not track the latest.

From a clone

uv sync
uv run google-cloud-support-mcp        # stdio
uv run fastmcp inspect                 # tool surface, without starting a session

fastmcp.json points the FastMCP CLI at server.py:create_server, so inspect, run and dev all work with no arguments.

{
  "mcpServers": {
    "google-cloud-support": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/google-cloud-support-mcp", "google-cloud-support-mcp"],
      "env": {
        "GOOGLE_CLOUD_SUPPORT_MCP_PARENTS": "[\"projects/my-project\",\"organizations/123456789\"]",
        "GOOGLE_CLOUD_SUPPORT_MCP_QUOTA_PROJECT": "my-project"
      }
    }
  }
}

Configuration

All variables take the GOOGLE_CLOUD_SUPPORT_MCP_ prefix.

Two things worth knowing

Nothing reaches Google without your confirmation. Every outward-facing action shows you the exact payload and waits. Declining sends nothing. The approved payload is sealed by the framework between rounds, so what executes is byte-for-byte what you were shown — a confirm: true parameter could not do this, because the model would be the one filling it in.

Escalation is off by default. It is delivered to Google's support organisation and a person acts on it. Set GOOGLE_CLOUD_SUPPORT_MCP_ENABLE_ESCALATION=true to expose the tool; it still requires a written justification and your confirmation.

Cross-organization queries

search_cases queries every configured scope in parallel and merges the results. A scope that fails does not fail the call — it appears in scopes_failed with what to do about it, so one organization's permission error never hides another organization's cases. Pagination uses a composite cursor that carries a token per scope; changing parents mid-pagination is rejected rather than silently skewing the results.

Known limitations

Attachment upload limits are unverified. MAX_UPLOAD_BYTES defaults to 10 MB, which is a placeholder rather than a measured ceiling — the API does not document one, and no live upload has been run against a project with a paid support plan. The limit may be higher or lower than the real one, and the transfer form is an informed reading of the media reference rather than a confirmed protocol.

A mistyped scope reports the wrong thing. Name a project that does not exist and the answer says the service is temporarily unreachable and suggests retrying. Retrying will not help: the upstream API returns a bare HTTP 500 for a nonexistent project, and a 500 carries nothing that separates a typo from a real outage — so reclassifying it would mislabel genuine outages instead. The scope still appears in scopes_failed rather than silently returning "no cases".

TODO.md has the full list and what would unblock each item.

Development

uv run pytest                  # unit + contract; integration is deselected
uv run ruff check . && uv run ruff format --check .
uv run fastmcp inspect         # the server must load through the FastMCP CLI