Google Cloud Storage MCP

Add to your client

Copy the config for your MCP client and paste it into its config file.

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

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

• Node.js 20 or higher
• The gcloud CLI installed and authenticated — run `gcloud auth application-default login` (or authorize gcloud as a service account) so Application Default Credentials are available
• A Google Cloud project with the Cloud Storage API enabled; set GOOGLE_CLOUD_PROJECT (or GCP_PROJECT_ID)
• IAM permissions on the target buckets/objects — the MCP inherits exactly the permissions of the authenticated identity

About Google Cloud Storage MCP

Tools & capabilities (14)

When to use it

• Use it when you want an agent to browse and manage GCS buckets and objects in plain language instead of writing gcloud/gsutil commands.
• Use it when you need to read object contents or metadata to feed into an LLM workflow.
• Use it when you want safe-by-default storage access where deletes and overwrites are opt-in.
• Use it when you need storage analytics — querying Storage Insights datasets to understand object counts, sizes, and metadata at scale.
• Use it when you want to audit access by viewing IAM policies or checking effective permissions on buckets.
• Use it when you're building automation in Gemini CLI, Claude, Cursor, or another MCP client against GCS.

Quick setup

1. 1Install Node.js 20+ and the gcloud CLI.
2. 2Authenticate: run `gcloud auth application-default login` and set GOOGLE_CLOUD_PROJECT.
3. 3For Gemini CLI, run `npx @google-cloud/storage-mcp init --agent=gemini-cli` (add `--enable-destructive-tools` to allow deletes/overwrites).
4. 4For other clients, add a server entry with command `npx` and args `-y @google-cloud/storage-mcp`.
5. 5Restart the client and verify (e.g. `gemini mcp list`), then try `list_buckets`.

Google Cloud Storage MCP FAQ