Skip to main content
MCP server CX Codex official · Google

Cloud Run — MCP server for app deployment to GCP

Google Cloud's MCP server enables AI agents to deploy apps to Cloud Run directly from IDEs and assistants. Integrates with Claude Code, Cursor, GitHub Copilot, and other platforms.

no license updated 2026-10-29

Open on GitHub

What Cloud Run does

The server exposes four core tools: deploying code from file contents, listing services, retrieving service details, and fetching logs. Built-in prompts—deploy and logs—provide shortcuts to common workflows. Running locally requires Google Cloud SDK and authentication via gcloud auth login and gcloud auth application-default login. Configure defaults through environment variables: GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_REGION, DEFAULT_SERVICE_NAME. Optional security: enable Host header validation with ENABLE_HOST_VALIDATION to mitigate DNS rebinding attacks.

What it helps with

  • deploy code to Cloud Run from an IDE agent
  • fetch logs and errors for a running service
  • list or inspect Cloud Run services in a project
  • manage Cloud Run resources via Gemini CLI

Example prompts for the agent

  • Deploy the current directory to Cloud Run
  • Show logs for the service named api-service
  • List all Cloud Run services in my project

How to install Cloud Run

Install

The MCP registry has no launch command for it: see the repository README

Step 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 Cloud Run

How do I set up Cloud Run in Claude Code?

Claude Code doesn't expose MCP configuration through its UI. Use Cursor, Windsurf, Cline, or Gemini CLI instead. For Gemini CLI, run gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp.

What tools does the server provide?

Four main tools: deploy-file-contents, list-services, get-service, and get-service-log. When running locally, you also get deploy-local-folder, list-projects, and create-project.

What prerequisites are needed?

Install Google Cloud SDK and authenticate: run gcloud auth login and gcloud auth application-default login. For Node.js setup, use Node.js LTS. Docker is an alternative to run locally without Node.js installed.

Similar MCP servers

All MCP servers for DevOps and infrastructure →

Project sponsors

Companies that keep this analytics open