# Google Cloud Storage MCP server

> Read, write, copy, download, and delete Google Cloud Storage buckets and objects with configurable tool groups.

- Repository: https://github.com/pulsemcp/mcp-servers
- Page: https://hostedmcp.org/servers/pulsemcp/gcs
- Official: yes
- Transport: stdio
- Stars: 81
- License: MIT
- Latest version: 0.1.14

## Install

### Claude Code

```sh
claude mcp add --env 'GCS_PROJECT_ID=<GCS_PROJECT_ID>' --env 'GCS_SERVICE_ACCOUNT_KEY_FILE=<YOUR_GCS_SERVICE_ACCOUNT_KEY_FILE>' --env 'GCS_SERVICE_ACCOUNT_KEY_JSON=<YOUR_GCS_SERVICE_ACCOUNT_KEY_JSON>' gcs -- npx -y gcs-google-mcp-server
```

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

```json
{
  "mcpServers": {
    "gcs": {
      "command": "npx",
      "args": [
        "-y",
        "gcs-google-mcp-server"
      ],
      "env": {
        "GCS_PROJECT_ID": "<GCS_PROJECT_ID>",
        "GCS_SERVICE_ACCOUNT_KEY_FILE": "<YOUR_GCS_SERVICE_ACCOUNT_KEY_FILE>",
        "GCS_SERVICE_ACCOUNT_KEY_JSON": "<YOUR_GCS_SERVICE_ACCOUNT_KEY_JSON>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "gcs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gcs-google-mcp-server"
      ],
      "env": {
        "GCS_PROJECT_ID": "<GCS_PROJECT_ID>",
        "GCS_SERVICE_ACCOUNT_KEY_FILE": "<YOUR_GCS_SERVICE_ACCOUNT_KEY_FILE>",
        "GCS_SERVICE_ACCOUNT_KEY_JSON": "<YOUR_GCS_SERVICE_ACCOUNT_KEY_JSON>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"gcs","type":"stdio","command":"npx","args":["-y","gcs-google-mcp-server"],"env":{"GCS_PROJECT_ID":"<GCS_PROJECT_ID>","GCS_SERVICE_ACCOUNT_KEY_FILE":"<YOUR_GCS_SERVICE_ACCOUNT_KEY_FILE>","GCS_SERVICE_ACCOUNT_KEY_JSON":"<YOUR_GCS_SERVICE_ACCOUNT_KEY_JSON>"}}'
```

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

```json
{
  "mcpServers": {
    "gcs": {
      "command": "npx",
      "args": [
        "-y",
        "gcs-google-mcp-server"
      ],
      "env": {
        "GCS_PROJECT_ID": "<GCS_PROJECT_ID>",
        "GCS_SERVICE_ACCOUNT_KEY_FILE": "<YOUR_GCS_SERVICE_ACCOUNT_KEY_FILE>",
        "GCS_SERVICE_ACCOUNT_KEY_JSON": "<YOUR_GCS_SERVICE_ACCOUNT_KEY_JSON>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add gcs --env 'GCS_PROJECT_ID=<GCS_PROJECT_ID>' --env 'GCS_SERVICE_ACCOUNT_KEY_FILE=<YOUR_GCS_SERVICE_ACCOUNT_KEY_FILE>' --env 'GCS_SERVICE_ACCOUNT_KEY_JSON=<YOUR_GCS_SERVICE_ACCOUNT_KEY_JSON>' -- npx -y gcs-google-mcp-server
```

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

```toml
[mcp_servers.gcs]
command = "npx"
args = ["-y", "gcs-google-mcp-server"]

[mcp_servers.gcs.env]
GCS_PROJECT_ID = "<GCS_PROJECT_ID>"
GCS_SERVICE_ACCOUNT_KEY_FILE = "<YOUR_GCS_SERVICE_ACCOUNT_KEY_FILE>"
GCS_SERVICE_ACCOUNT_KEY_JSON = "<YOUR_GCS_SERVICE_ACCOUNT_KEY_JSON>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'GCS_PROJECT_ID=<GCS_PROJECT_ID>' -e 'GCS_SERVICE_ACCOUNT_KEY_FILE=<YOUR_GCS_SERVICE_ACCOUNT_KEY_FILE>' -e 'GCS_SERVICE_ACCOUNT_KEY_JSON=<YOUR_GCS_SERVICE_ACCOUNT_KEY_JSON>' gcs npx -- -y gcs-google-mcp-server
```

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

```json
{
  "mcpServers": {
    "gcs": {
      "command": "npx",
      "args": [
        "-y",
        "gcs-google-mcp-server"
      ],
      "env": {
        "GCS_PROJECT_ID": "<GCS_PROJECT_ID>",
        "GCS_SERVICE_ACCOUNT_KEY_FILE": "<YOUR_GCS_SERVICE_ACCOUNT_KEY_FILE>",
        "GCS_SERVICE_ACCOUNT_KEY_JSON": "<YOUR_GCS_SERVICE_ACCOUNT_KEY_JSON>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GCS_PROJECT_ID` | yes | no | Google Cloud project ID. |
| `GCS_SERVICE_ACCOUNT_KEY_FILE` | no | yes | Path to service account key JSON file. |
| `GCS_SERVICE_ACCOUNT_KEY_JSON` | no | yes | Service account key JSON contents (inline). |
| `GCS_BUCKET` | no | no | Constrain all operations to a single bucket (hides bucket-level tools). |
| `GCS_DISABLED_TOOLS` | no | no | Comma-separated list of specific tools to disable. |
| `GCS_ENABLED_TOOLGROUPS` | no | no | Comma-separated tool groups to enable (readonly, readwrite, delete). |
| `GCS_ENABLED_TOOLS` | no | no | Comma-separated list of specific tools to enable (overrides groups). |
| `SKIP_HEALTH_CHECKS` | no | no | Skip health checks on startup. |

## Tools (16)

- `list_buckets`
- `list_objects`
- `get_object`
- `download_object`
- `download_prefix`
- `head_bucket`
- `put_object`
- `put_object_from_path`
- `upload_prefix`
- `copy_object`
- `create_bucket`
- `delete_object`
- `delete_bucket`
- `readonly`
- `readwrite`
- `delete`

## FAQ

### How do I limit the GCS MCP server to read-only tools?

Set the GCS_ENABLED_TOOLGROUPS environment variable to readonly, or enable only specific tools with GCS_ENABLED_TOOLS.

### How does the GCS MCP server authenticate to Google Cloud?

It supports a service account key file, inline JSON credentials, or Application Default Credentials.

### Can I restrict the server to a single bucket?

Yes, set GCS_BUCKET and all object operations are scoped to that bucket, with bucket-level tools hidden.

### How do I upload a whole local directory to GCS without using model context?

Use the upload_prefix tool, which streams files from disk preserving directory structure as key paths.

### How do I download every object under a prefix to local disk?

Use download_prefix, which paginates the full listing and writes raw bytes to a local directory, returning a manifest.
