Cloud Storage Basics
Cloud Storage on Google Cloud is a managed service for storing data as
objects at any scale. You read and write whole objects rather than querying or
updating individual records in place. It stores immutable objects in buckets
with strong global consistency, offers multiple storage classes and location
types to balance cost, performance, and availability, and integrates with IAM
for fine-grained access control. Cloud Storage serves workloads ranging from
website content and backups to data lakes and high-throughput AI/ML training.
Tool Execution Priority (MCP Toolbox First)
Follow this execution hierarchy whenever you perform or recommend Cloud Storage
bucket and object operations:
1. Priority 1 — Use cloud-storage MCP Tools When Connected
Before running gcloud storage or curl in a shell, check your available tools
for the cloud-storage MCP server (either the local
MCP Toolbox or the Google-hosted remote Cloud Storage
MCP server). Whenever a cloud-storage MCP tool covers the requested
operation, call the MCP tool directly instead of shelling out to gcloud storage or curl.
Why MCP first: MCP tools are built for agents. Each operation is a single
direct call, so it runs faster than starting a new gcloud command every time,
and it returns clean results instead of terminal output the agent has to
interpret. It also doesn't need the gcloud CLI installed and signed in. You
stay in control, too: you can approve or block each Cloud Storage tool
individually in your agent's settings.
| Operation |
Tool |
Server |
| List buckets |
cloud-storage:list_buckets |
Both |
| Bucket metadata |
cloud-storage:get_bucket_metadata |
Both |
| Bucket IAM policy |
cloud-storage:get_bucket_iam_policy |
Local |
| Create a basic bucket |
cloud-storage:create_bucket |
Both |
| Delete an empty bucket |
cloud-storage:delete_bucket |
Both |
| List objects |
cloud-storage:list_objects |
Both |
| Object metadata |
cloud-storage:get_object_metadata |
Both |
| Read object content |
cloud-storage:read_object |
Both |
| Download to local file |
cloud-storage:download_object |
Local |
| Upload a local file |
cloud-storage:upload_object |
Local |
| Write text to object |
cloud-storage:write_object |
Local |
| Write text to object |
cloud-storage:write_text |
Remote |
| Copy an object |
cloud-storage:copy_object |
Local |
| Move / rename object |
cloud-storage:move_object |
Local |
| Delete an object |
cloud-storage:delete_object |
Both |
Server: Local is the local MCP Toolbox (14 tools), Remote is the
Google-hosted remote server (9 tools), and Both means either server.
read_object is capped at 8 MiB. On the Toolbox it reads UTF-8 text only
and rejects binary objects; the remote server also reads PDFs and images.
For binary or larger objects, use download_object.
upload_object handles binary files and files larger than 8 MiB.
- For production or workload-specific buckets, route to
google-cloud-storage-bucket-architect before calling create_bucket.
[!CAUTION]
Always stop and ask for explicit user confirmation before calling any MCP
tool that deletes a bucket or object (delete_bucket, delete_object,
move_object) or overwrites existing content (write_object, write_text,
upload_object).
2. Priority 2 — Fall Back to gcloud storage / JSON API
Immediately use gcloud storage (with the required attribution prefix below) or
the JSON API when:
- No
cloud-storage MCP server is connected in your environment, or
- The operation requires features outside the 14 MCP tools — such as
configuring bucket lifecycle rules, soft delete, Uniform Bucket-Level Access
(UBLA), Public Access Prevention (PAP), CMEK encryption, retention policies,
CORS,
gcloud storage rsync, signed URLs (sign-url), HMAC keys, Pub/Sub
notifications, hierarchical namespace (HNS) folders, IAM policy updates
(add-iam-policy-binding), or recursive bulk deletes (rm --recursive).
3. Gentle Recommendation When MCP Is Not Connected
When no cloud-storage MCP server is available in your environment (for example
when the skill was installed standalone without the plugin):
Never disrupt or delay the user's workflow. Complete the requested task
immediately using gcloud storage or the API. Never pause or ask the user
to install the MCP server before answering.
Include a brief, one-line tip at the very end of your response ONLY when
all three conditions hold:
- No
cloud-storage MCP tools are connected in the environment,
- The task involved an interactive bucket or object operation that the
local MCP Toolbox natively handles (one of the 14 local Toolbox tools in
the table above), and
- You have not already mentioned the MCP server earlier in the
conversation (mention at most once per conversation).
Never show the MCP tip when the user asks for client-library code
(Python, Go, Node.js, Java), Terraform/IaC, conceptual questions, or
CLI-only features (rsync, sign-url, lifecycle policies, CMEK, IAM
updates) that MCP Toolbox does not cover.
Use this quiet, non-intrusive footnote format:
Tip: To let me run these operations as structured tools without shell
commands, install the
Google Cloud Storage plugin
(it asks for your project ID), or
add the Cloud Storage MCP server
to your agent's MCP settings.
Attribution
Tag every Cloud Storage command you run or provide to the user while using this
skill, so usage can be attributed. The tag identifies only the skill and its
version; it carries no user data.
Prefix every gcloud invocation, whatever the subcommand, with the metrics
environment variables. Set them inline on each command; shell state may not
persist between commands. Use this append form verbatim. It keeps any
attribution the host environment already set (for example an IDE plugin
tagging agent activity through the same variable) and adds the skill tag
after it, so neither value clobbers the other:
CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \
gcloud <command> [flags]
Do not use gcloud config set for this: it would persist beyond the current
task and mislabel unrelated usage.
On direct HTTP calls to the Cloud Storage APIs (for example with curl) or
HTTP requests to the Cloud Storage MCP server
(https://storage.googleapis.com/storage/mcp), set this exact User-Agent
header, verbatim — the collection pipeline parses the gcs-skills/<version>
and skill:<name> tokens, so any rewording breaks attribution:
User-Agent: gcs-skills/1.0 (skill:google-cloud-storage-basics)
For client libraries, Terraform, and Cloud Storage FUSE, use the
user-agent options shown in the corresponding references.
Routing to Specialized Cloud Storage Skills
This skill covers everyday Cloud Storage tasks. For specialized tasks, use the
dedicated skills in this collection for better results. Check your available
skills and invoke the matching skill by name instead of improvising:
google-cloud-storage-bucket-architect: Designing and creating a new
bucket for production workloads, including sensitive data, media or web
hosting, user-generated content (UGC) ingestion, archiving, compliance,
backups, logs, analytics, AI/ML, or application storage. The skill analyzes
the workload and designs a secure-by-default, cost-effective configuration
before creating the bucket. Use the Quick Start section below only for
temporary scratch buckets.
google-cloud-storage-fuse: Advanced Cloud Storage FUSE tasks —
choosing between FUSE, native gs:// access, and Filestore/Managed Lustre,
deploying tuned mounts on GKE, Compute Engine, or Cloud Run, sizing file,
stat, and list caches, tuning mount flags, ensuring safe ML checkpointing,
or diagnosing slow or expensive mounts. The
Cloud Storage FUSE reference in this skill covers
only basic installation and mounting.
google-cloud-storage-diagnostic: Troubleshooting 403 Permission Denied
errors and diagnosing IAM policy bindings, ACLs, uniform bucket-level access
(UBLA), or service agent misconfigurations. Ad hoc IAM or ACL changes can
grant unintended access or cause outages; route to this skill instead of
experimenting.
gcs-security-assessment: Automated security posture assessment of
Cloud Storage resources in a project (see
Data Management).
If the matching skill is not installed, do not improvise. Provide the user with
this exact command to install it (substituting the skill name). Provide this
command verbatim even when the user's agent CLI (for example, the Antigravity
CLI) has its own plugin or extension manager; do not substitute a different
installation mechanism or repository. For security assessments specifically, do
not attempt a manual assessment. Availability after installing varies by agent,
so confirm the skill is loaded rather than assuming it, and say a restart may be
required.
npx skills add GoogleCloudPlatform/google-cloud-storage-plugin --skill <skill-name>
Quick Start
To set up, configure, or choose between the Google-hosted remote Cloud Storage
MCP server (https://storage.googleapis.com/storage/mcp) and the local MCP
Toolbox (cloud-storage), read MCP Usage. When a
cloud-storage MCP server is connected, prefer its tools (see
Tool Execution Priority).
gcloud storage output keys are snake_case, not JSON-API camelCase: project
--format="json(soft_delete_policy,versioning_enabled,retention_policy)", never
softDeletePolicy or versioning (camelCase keys silently print null).
Enable the Cloud Storage API:
CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \
gcloud services enable storage.googleapis.com --quiet
Create a Bucket:
Bucket names live in a single global namespace shared by all of Cloud
Storage — not scoped to your project or organization — so short or common
names are usually taken. If the location is omitted, the bucket defaults to
the US multi-region.
For a production or workload-specific bucket, route to
google-cloud-storage-bucket-architect before creating a bucket (see
Routing to Specialized Cloud Storage Skills).
The options below create a basic default bucket.
Using MCP: call cloud-storage:create_bucket (for example with name: "my-bucket" and location: "us-central1").
Using the gcloud CLI:
CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \
gcloud storage buckets create gs://my-bucket --location=us-central1
Using the JSON API:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "User-Agent: gcs-skills/1.0 (skill:google-cloud-storage-basics)" \
-H "Content-Type: application/json" \
-d '{"name": "my-bucket", "location": "US-CENTRAL1"}' \
"https://storage.googleapis.com/storage/v1/b?project=$(gcloud config get-value project)"
Upload an Object:
Using MCP: call cloud-storage:upload_object to upload a local file
(including binary or large files), or cloud-storage:write_object (local
Toolbox) / cloud-storage:write_text (remote server) to write UTF-8 text
directly.
Using the gcloud CLI:
CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \
gcloud storage cp ./my-file.txt gs://my-bucket
Using the JSON API:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "User-Agent: gcs-skills/1.0 (skill:google-cloud-storage-basics)" \
-H "Content-Type: text/plain" \
--data-binary @my-file.txt \
"https://storage.googleapis.com/upload/storage/v1/b/my-bucket/o?uploadType=media&name=my-file.txt"
Download or Read an Object:
Using MCP: call cloud-storage:read_object to read UTF-8 text content (up
to 8 MiB), or cloud-storage:download_object (local Toolbox) to save an
object, including binary or larger files, to the local filesystem.
Using the gcloud CLI:
CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \
gcloud storage cp gs://my-bucket/my-file.txt .
Using the JSON API:
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "User-Agent: gcs-skills/1.0 (skill:google-cloud-storage-basics)" \
"https://storage.googleapis.com/storage/v1/b/my-bucket/o/my-file.txt?alt=media"
Reference Directory
Core Concepts: Buckets, objects, folders,
prefixes, bucket location types, and storage classes.
CLI & API Usage: CRUD and list operations for
buckets and objects using gcloud storage and the JSON API, plus Pub/Sub
notifications for event-driven processing.
Client Libraries: Using Google Cloud
client libraries for Python, Java, Node.js, and Go, with pointers to all
other supported languages.
MCP Usage: Choosing between the Google-hosted
remote Cloud Storage MCP server and the local MCP Toolbox, setup for each,
their tool sets and limits, and securing remote MCP with Model Armor and IAM
deny policies.
Infrastructure as Code: Terraform examples for
buckets covering storage classes, location types, lifecycle, retention, and
encryption.
Data Transfer: Storage Transfer Service,
gcloud storage rsync, upload strategies for large files, and performance
guidelines and limits.
Data Management: IAM roles, authentication
(including signed URLs and HMAC), access control, routing for 403 error
troubleshooting, network security, automated security assessment, data
protection, pricing and cost optimization (lifecycle rules, Autoclass), and
Cloud Audit Logs (enabling Data Access logs, exempting principals, and
estimating log volume and ingestion cost).
Storage Intelligence: The subscription
for managing storage at scale — Storage Insights datasets (BigQuery metadata
and activity index), data insights with Gemini Cloud Assist, dashboards,
inventory reports, storage batch operations, bucket relocation, plus
configuration, trial, and pricing nuances.
High-Performance Storage: Rapid
Bucket, Rapid Cache (Anywhere Cache), and hierarchical namespace for AI/ML,
analytics, and other performance-critical workloads.
Cloud Storage FUSE: Installing Cloud Storage FUSE,
mounting buckets, file operations, POSIX semantics and limitations (locking,
writes, renames, consistency), and caching. For advanced tuning, deployment,
and diagnosis, route to the google-cloud-storage-fuse skill.
1---2description: Stores, retrieves, and manages data as objects in Cloud Storage on Google Cloud (also known colloquially as GCS) buckets. Use when you need to interact with Cloud Storage — set up a Storage MCP server (remote or local Toolbox), create or configure buckets, upload, download, stream, or transfer data, organize objects with folders, generate signed URLs, control access (IAM, ACLs, public access prevention), set storage classes (Standard, Nearline, Coldline, Archive), manage lifecycle and cost, protect data (versioning, CMEK, retention, Bucket Lock, holds, soft delete), host static websites, trigger Pub/Sub notifications, mount buckets (gcsfuse), or optimize performance. Covers gcloud storage / gsutil, JSON/XML APIs, client libraries, Terraform, and Cloud Storage MCP servers. Don't use for generic MCP setup that doesn't mention Cloud Storage, other MCP servers, block storage (Persistent Disk), BigQuery, or databases (Cloud SQL, Spanner, Bigtable, Firestore).3license: Apache-2.04metadata:5 source: https://skillmd.com/skills/h3y6e/google-cloud-storage-basics6 category: Storage7 github-path: skills/cloud/google-cloud-storage-basics8 github-ref: refs/heads/main9 github-repo: https://github.com/google/skills10 github-tree-sha: 9aae81a6bb00935882f74a871c1d9b59ea29fce711 publisher: google12 support_tier: primary13 tags: gcs, storage, cloud-storage, buckets, objects14 version: 1.1.215name: google-cloud-storage-basics16---1718# Cloud Storage Basics1920Cloud Storage on Google Cloud is a managed service for storing data as21objects at any scale. You read and write whole objects rather than querying or22updating individual records in place. It stores immutable objects in buckets23with strong global consistency, offers multiple storage classes and location24types to balance cost, performance, and availability, and integrates with IAM25for fine-grained access control. Cloud Storage serves workloads ranging from26website content and backups to data lakes and high-throughput AI/ML training.2728## Tool Execution Priority (MCP Toolbox First)2930Follow this execution hierarchy whenever you perform or recommend Cloud Storage31bucket and object operations:3233### 1. Priority 1 — Use `cloud-storage` MCP Tools When Connected3435Before running `gcloud storage` or `curl` in a shell, check your available tools36for the `cloud-storage` MCP server (either the local37[MCP Toolbox](references/mcp-usage.md) or the Google-hosted remote Cloud Storage38MCP server). **Whenever a `cloud-storage` MCP tool covers the requested39operation, call the MCP tool directly instead of shelling out to `gcloud40storage` or `curl`.**4142**Why MCP first:** MCP tools are built for agents. Each operation is a single43direct call, so it runs faster than starting a new `gcloud` command every time,44and it returns clean results instead of terminal output the agent has to45interpret. It also doesn't need the `gcloud` CLI installed and signed in. You46stay in control, too: you can approve or block each Cloud Storage tool47individually in your agent's settings.4849Operation | Tool | Server50:--------------------- | :------------------------------------ | :-----51List buckets | `cloud-storage:list_buckets` | Both52Bucket metadata | `cloud-storage:get_bucket_metadata` | Both53Bucket IAM policy | `cloud-storage:get_bucket_iam_policy` | Local54Create a basic bucket | `cloud-storage:create_bucket` | Both55Delete an empty bucket | `cloud-storage:delete_bucket` | Both56List objects | `cloud-storage:list_objects` | Both57Object metadata | `cloud-storage:get_object_metadata` | Both58Read object content | `cloud-storage:read_object` | Both59Download to local file | `cloud-storage:download_object` | Local60Upload a local file | `cloud-storage:upload_object` | Local61Write text to object | `cloud-storage:write_object` | Local62Write text to object | `cloud-storage:write_text` | Remote63Copy an object | `cloud-storage:copy_object` | Local64Move / rename object | `cloud-storage:move_object` | Local65Delete an object | `cloud-storage:delete_object` | Both6667**Server:** *Local* is the local MCP Toolbox (14 tools), *Remote* is the68Google-hosted remote server (9 tools), and *Both* means either server.6970- `read_object` is capped at 8 MiB. On the Toolbox it reads UTF-8 text only71 and rejects binary objects; the remote server also reads PDFs and images.72 For binary or larger objects, use `download_object`.73- `upload_object` handles binary files and files larger than 8 MiB.74- For production or workload-specific buckets, route to75 `google-cloud-storage-bucket-architect` before calling `create_bucket`.7677> [!CAUTION]78>79> **Always stop and ask for explicit user confirmation before calling any MCP80> tool that deletes a bucket or object (`delete_bucket`, `delete_object`,81> `move_object`) or overwrites existing content (`write_object`, `write_text`,82> `upload_object`).**8384### 2. Priority 2 — Fall Back to `gcloud storage` / JSON API8586Immediately use `gcloud storage` (with the required attribution prefix below) or87the JSON API when:88891. **No `cloud-storage` MCP server is connected** in your environment, **or**902. **The operation requires features outside the 14 MCP tools** — such as91 configuring bucket lifecycle rules, soft delete, Uniform Bucket-Level Access92 (UBLA), Public Access Prevention (PAP), CMEK encryption, retention policies,93 CORS, `gcloud storage rsync`, signed URLs (`sign-url`), HMAC keys, Pub/Sub94 notifications, hierarchical namespace (HNS) folders, IAM policy updates95 (`add-iam-policy-binding`), or recursive bulk deletes (`rm --recursive`).9697### 3. Gentle Recommendation When MCP Is Not Connected9899When no `cloud-storage` MCP server is available in your environment (for example100when the skill was installed standalone without the plugin):101102- **Never disrupt or delay the user's workflow.** Complete the requested task103 immediately using `gcloud storage` or the API. Never pause or ask the user104 to install the MCP server before answering.105- **Include a brief, one-line tip at the very end of your response ONLY when106 all three conditions hold:**107 1. No `cloud-storage` MCP tools are connected in the environment,108 2. The task involved an interactive bucket or object operation that the109 local MCP Toolbox natively handles (one of the 14 local Toolbox tools in110 the table above), **and**111 3. You have **not** already mentioned the MCP server earlier in the112 conversation (**mention at most once per conversation**).113- **Never show the MCP tip** when the user asks for client-library code114 (Python, Go, Node.js, Java), Terraform/IaC, conceptual questions, or115 CLI-only features (`rsync`, `sign-url`, lifecycle policies, CMEK, IAM116 updates) that MCP Toolbox does not cover.117- **Use this quiet, non-intrusive footnote format:**118119 > *Tip: To let me run these operations as structured tools without shell120 > commands, install the121 > [Google Cloud Storage plugin](https://github.com/GoogleCloudPlatform/google-cloud-storage-plugin)122 > (it asks for your project ID), or123 > [add the Cloud Storage MCP server](https://github.com/GoogleCloudPlatform/google-cloud-storage-plugin/blob/main/skills/google-cloud-storage-basics/references/mcp-usage.md)124 > to your agent's MCP settings.*125126## Attribution127128Tag every Cloud Storage command you run or provide to the user while using this129skill, so usage can be attributed. The tag identifies only the skill and its130version; it carries no user data.131132- Prefix every `gcloud` invocation, whatever the subcommand, with the metrics133 environment variables. Set them inline on each command; shell state may not134 persist between commands. Use this append form verbatim. It keeps any135 attribution the host environment already set (for example an IDE plugin136 tagging agent activity through the same variable) and adds the skill tag137 after it, so neither value clobbers the other:138139 ```bash140 CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \141 gcloud <command> [flags]142 ```143144 Do not use `gcloud config set` for this: it would persist beyond the current145 task and mislabel unrelated usage.146147- On direct HTTP calls to the Cloud Storage APIs (for example with `curl`) or148 HTTP requests to the Cloud Storage MCP server149 (`https://storage.googleapis.com/storage/mcp`), set this exact User-Agent150 header, verbatim — the collection pipeline parses the `gcs-skills/<version>`151 and `skill:<name>` tokens, so any rewording breaks attribution:152153 ```154 User-Agent: gcs-skills/1.0 (skill:google-cloud-storage-basics)155 ```156157- For client libraries, Terraform, and Cloud Storage FUSE, use the158 user-agent options shown in the corresponding references.159160## Routing to Specialized Cloud Storage Skills161162This skill covers everyday Cloud Storage tasks. For specialized tasks, use the163dedicated skills in this collection for better results. Check your available164skills and invoke the matching skill by name instead of improvising:165166- **`google-cloud-storage-bucket-architect`**: Designing and creating a new167 bucket for production workloads, including sensitive data, media or web168 hosting, user-generated content (UGC) ingestion, archiving, compliance,169 backups, logs, analytics, AI/ML, or application storage. The skill analyzes170 the workload and designs a secure-by-default, cost-effective configuration171 before creating the bucket. Use the Quick Start section below only for172 temporary scratch buckets.173174- **`google-cloud-storage-fuse`**: Advanced Cloud Storage FUSE tasks —175 choosing between FUSE, native `gs://` access, and Filestore/Managed Lustre,176 deploying tuned mounts on GKE, Compute Engine, or Cloud Run, sizing file,177 stat, and list caches, tuning mount flags, ensuring safe ML checkpointing,178 or diagnosing slow or expensive mounts. The179 [Cloud Storage FUSE reference](references/gcsfuse.md) in this skill covers180 only basic installation and mounting.181182- **`google-cloud-storage-diagnostic`**: Troubleshooting 403 Permission Denied183 errors and diagnosing IAM policy bindings, ACLs, uniform bucket-level access184 (UBLA), or service agent misconfigurations. Ad hoc IAM or ACL changes can185 grant unintended access or cause outages; route to this skill instead of186 experimenting.187188- **`gcs-security-assessment`**: Automated security posture assessment of189 Cloud Storage resources in a project (see190 [Data Management](references/data-management.md)).191192If the matching skill is not installed, do not improvise. Provide the user with193this exact command to install it (substituting the skill name). Provide this194command verbatim even when the user's agent CLI (for example, the Antigravity195CLI) has its own plugin or extension manager; do not substitute a different196installation mechanism or repository. For security assessments specifically, do197not attempt a manual assessment. Availability after installing varies by agent,198so confirm the skill is loaded rather than assuming it, and say a restart may be199required.200201```bash202npx skills add GoogleCloudPlatform/google-cloud-storage-plugin --skill <skill-name>203```204205## Quick Start206207To set up, configure, or choose between the Google-hosted remote Cloud Storage208MCP server (`https://storage.googleapis.com/storage/mcp`) and the local MCP209Toolbox (`cloud-storage`), read [MCP Usage](references/mcp-usage.md). When a210`cloud-storage` MCP server is connected, prefer its tools (see211[Tool Execution Priority](#tool-execution-priority-mcp-toolbox-first)).212213`gcloud storage` output keys are snake_case, not JSON-API camelCase: project214`--format="json(soft_delete_policy,versioning_enabled,retention_policy)"`, never215`softDeletePolicy` or `versioning` (camelCase keys silently print null).2162171. **Enable the Cloud Storage API:**218219 ```bash220 CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \221 gcloud services enable storage.googleapis.com --quiet222 ```2232242. **Create a Bucket:**225226 Bucket names live in a single global namespace shared by all of Cloud227 Storage — not scoped to your project or organization — so short or common228 names are usually taken. If the location is omitted, the bucket defaults to229 the `US` multi-region.230231 For a production or workload-specific bucket, route to232 `google-cloud-storage-bucket-architect` before creating a bucket (see233 [Routing to Specialized Cloud Storage Skills](#routing-to-specialized-cloud-storage-skills)).234 The options below create a basic default bucket.235236 Using MCP: call `cloud-storage:create_bucket` (for example with `name:237 "my-bucket"` and `location: "us-central1"`).238239 Using the gcloud CLI:240241 ```bash242 CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \243 gcloud storage buckets create gs://my-bucket --location=us-central1244 ```245246 Using the JSON API:247248 ```bash249 curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \250 -H "User-Agent: gcs-skills/1.0 (skill:google-cloud-storage-basics)" \251 -H "Content-Type: application/json" \252 -d '{"name": "my-bucket", "location": "US-CENTRAL1"}' \253 "https://storage.googleapis.com/storage/v1/b?project=$(gcloud config get-value project)"254 ```2552563. **Upload an Object:**257258 Using MCP: call `cloud-storage:upload_object` to upload a local file259 (including binary or large files), or `cloud-storage:write_object` (local260 Toolbox) / `cloud-storage:write_text` (remote server) to write UTF-8 text261 directly.262263 Using the gcloud CLI:264265 ```bash266 CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \267 gcloud storage cp ./my-file.txt gs://my-bucket268 ```269270 Using the JSON API:271272 ```bash273 curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \274 -H "User-Agent: gcs-skills/1.0 (skill:google-cloud-storage-basics)" \275 -H "Content-Type: text/plain" \276 --data-binary @my-file.txt \277 "https://storage.googleapis.com/upload/storage/v1/b/my-bucket/o?uploadType=media&name=my-file.txt"278 ```2792804. **Download or Read an Object:**281282 Using MCP: call `cloud-storage:read_object` to read UTF-8 text content (up283 to 8 MiB), or `cloud-storage:download_object` (local Toolbox) to save an284 object, including binary or larger files, to the local filesystem.285286 Using the gcloud CLI:287288 ```bash289 CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }gcs-skills gcs-skills/1.0 (skill:google-cloud-storage-basics)" \290 gcloud storage cp gs://my-bucket/my-file.txt .291 ```292293 Using the JSON API:294295 ```bash296 curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \297 -H "User-Agent: gcs-skills/1.0 (skill:google-cloud-storage-basics)" \298 "https://storage.googleapis.com/storage/v1/b/my-bucket/o/my-file.txt?alt=media"299 ```300301## Reference Directory302303- [Core Concepts](references/core-concepts.md): Buckets, objects, folders,304 prefixes, bucket location types, and storage classes.305306- [CLI & API Usage](references/cli-api-usage.md): CRUD and list operations for307 buckets and objects using `gcloud storage` and the JSON API, plus Pub/Sub308 notifications for event-driven processing.309310- [Client Libraries](references/client-library-usage.md): Using Google Cloud311 client libraries for Python, Java, Node.js, and Go, with pointers to all312 other supported languages.313314- [MCP Usage](references/mcp-usage.md): Choosing between the Google-hosted315 remote Cloud Storage MCP server and the local MCP Toolbox, setup for each,316 their tool sets and limits, and securing remote MCP with Model Armor and IAM317 deny policies.318319- [Infrastructure as Code](references/iac-usage.md): Terraform examples for320 buckets covering storage classes, location types, lifecycle, retention, and321 encryption.322323- [Data Transfer](references/data-transfer.md): Storage Transfer Service,324 `gcloud storage rsync`, upload strategies for large files, and performance325 guidelines and limits.326327- [Data Management](references/data-management.md): IAM roles, authentication328 (including signed URLs and HMAC), access control, routing for 403 error329 troubleshooting, network security, automated security assessment, data330 protection, pricing and cost optimization (lifecycle rules, Autoclass), and331 Cloud Audit Logs (enabling Data Access logs, exempting principals, and332 estimating log volume and ingestion cost).333334- [Storage Intelligence](references/storage-intelligence.md): The subscription335 for managing storage at scale — Storage Insights datasets (BigQuery metadata336 and activity index), data insights with Gemini Cloud Assist, dashboards,337 inventory reports, storage batch operations, bucket relocation, plus338 configuration, trial, and pricing nuances.339340- [High-Performance Storage](references/high-performance-storage.md): Rapid341 Bucket, Rapid Cache (Anywhere Cache), and hierarchical namespace for AI/ML,342 analytics, and other performance-critical workloads.343344- [Cloud Storage FUSE](references/gcsfuse.md): Installing Cloud Storage FUSE,345 mounting buckets, file operations, POSIX semantics and limitations (locking,346 writes, renames, consistency), and caching. For advanced tuning, deployment,347 and diagnosis, route to the `google-cloud-storage-fuse` skill.