gemini-cloud-assist-mcp — Claude Code MCP server: install
gemini-cloud-assist-mcp connects your agent to Cloud Operator for Google Cloud: incident investigation, Terraform and manifest review, cost analysis. Access requires Private Preview allowlisting.
Apache-2.0 ★ 72 updated 2026-10-17
claude mcp add gemini-cloud-assist-mcp -- npx -y @google-cloud/gemini-cloud-assist-mcpWhat gemini-cloud-assist-mcp does
This server links your coding agent to Cloud Operator, a Google Cloud agent that works against your live project. Through ask_cloud_operator you can hand it incident and root-cause work, rollout checks, Terraform or Kubernetes and Helm review and generation, and cost analysis. File changes come back as edits you can look over before accepting.
The first tool, ask_cloud_operator, starts a task and returns a contextId that you pass on follow-up calls. search_operator_sessions lists your sessions in a project, and fetch_operator_session loads one by contextId along with its turns. The endpoint is https://geminicloudassist.googleapis.com/mcp/autocloud.
You need the Google Cloud SDK, a Google Cloud project, and two IAM roles: roles/serviceusage.serviceUsageAdmin and roles/geminicloudassist.user. Auth runs on Application Default Credentials, so sign in with gcloud auth login and then gcloud auth application-default login. The service is in Private Preview, and a project outside the allowlist gets no access. The remote architecture needs v0.8.0 or newer.
What it helps with
- trace the root cause of an incident in a Google Cloud project
- check whether a rollout is ready and how it is being monitored
- review Terraform and get fixes as file edits
- generate Kubernetes and Helm manifests
- find where project spend can be cut
Example prompts for the agent
- Use ask_cloud_operator to find out why my service started returning errors
- Ask Cloud Operator to review
main.tfagainst Terraform best practices - List my Cloud Operator sessions in this project with
search_operator_sessions
How to install gemini-cloud-assist-mcp
Platform CLI
claude mcp add gemini-cloud-assist-mcp -- npx -y @google-cloud/gemini-cloud-assist-mcpPlatform CLI
codex mcp add gemini-cloud-assist-mcp -- npx -y @google-cloud/gemini-cloud-assist-mcpConfig file
{
"mcpServers": {
"gemini-cloud-assist-mcp": {
"command": "npx",
"args": [
"-y",
"@google-cloud/gemini-cloud-assist-mcp"
]
}
}
}Config file
{
"servers": {
"gemini-cloud-assist-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@google-cloud/gemini-cloud-assist-mcp"
]
}
}
}Platform CLI
gemini mcp add gemini-cloud-assist-mcp npx -y @google-cloud/gemini-cloud-assist-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about gemini-cloud-assist-mcp
How do I install gemini-cloud-assist-mcp in Claude Code?
Run claude mcp add gemini-cloud-assist-mcp -- npx -y @google-cloud/gemini-cloud-assist-mcp. Before that, sign in with gcloud auth login and gcloud auth application-default login.
What does gemini-cloud-assist-mcp do?
It gives your agent access to Cloud Operator, which investigates incidents, reviews rollouts, checks Terraform, Kubernetes and Helm files, analyzes costs, and answers Google Cloud questions.
What does the cloud-operator plugin do in Claude Code?
The plugin in plugins/cloud-operator sets up the Cloud Operator connection with a 30-minute tool timeout, stores your Google Cloud preferences, and adds a skill. Its commands start with /cloud-operator:. It replaces the repository's root plugin, so install only one of them.