# Cloud Run MCP server

> Deploys applications and files to Google Cloud Run and lists services, projects, and service logs.

- Repository: https://github.com/GoogleCloudPlatform/cloud-run-mcp
- Page: https://hostedmcp.org/servers/googlecloudplatform/cloud-run-mcp
- Transport: stdio
- Stars: 639
- License: Apache-2.0

## Install

### Claude Code

```sh
claude mcp add cloud-run-mcp -- npx -y @google-cloud/cloud-run-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "cloud-run-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "cloud-run-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"cloud-run-mcp","type":"stdio","command":"npx","args":["-y","@google-cloud/cloud-run-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "cloud-run-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add cloud-run-mcp -- npx -y @google-cloud/cloud-run-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.cloud-run-mcp]
command = "npx"
args = ["-y", "@google-cloud/cloud-run-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user cloud-run-mcp npx -- -y @google-cloud/cloud-run-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "cloud-run-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@google-cloud/cloud-run-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `DEFAULT_SERVICE_NAME` | no | no |  |
| `GOOGLE_APPLICATION_CREDENTIALS` | no | no |  |
| `GOOGLE_CLOUD_PROJECT` | no | no |  |
| `GOOGLE_CLOUD_REGION` | no | no |  |

## Tools (7)

- `deploy-file-contents`
- `list-services`
- `get-service`
- `get-service-log`
- `deploy-local`
- `list`
- `create`

## FAQ

### What can the Cloud Run MCP server do?

It lets AI agents deploy files or local folders to Cloud Run, list and inspect services, fetch service logs, and manage GCP projects when run locally.

### How do I install the Cloud Run MCP server with Node.js?

Add it to your MCP client config with the npx command and the @google-cloud/cloud-run-mcp package.

### Does the Cloud Run MCP server support OAuth?

Yes, OAuth 2.0 Bearer token verification can be enabled for incoming HTTP/SSE requests.

### Which tools are only available when running locally?

deploy-local-folder, list-projects, and create-project are only available when the server runs locally.

### How do I authenticate before using the server?

Log in with gcloud auth login and set up application default credentials.