The Google Cloud Storage connector lets your AI agent act in each user's Google Cloud Storage account. Each user signs in to Google Cloud Storage once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 22 tools.
- Tools
- 22
- What they doRead · write · destructive
- 10 · 9 · 310 read9 write3 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Google Cloud Storage app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Google Cloud Storage connection
In AgentKit > Connections, create a Google Cloud Storage connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Google Cloud Storage connections use your own OAuth app. Register one with Google Cloud Storage and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Google Cloud Storage connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'googlecloudstorage'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Google Cloud Storage:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'googlecloudstorage_bucket_get',toolInput: { bucket: 'YOUR_BUCKET' },})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "googlecloudstorage"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Google Cloud Storage:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={"bucket":"YOUR_BUCKET"},tool_name="googlecloudstorage_bucket_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolgooglecloudstorage_bucket_getGet the settings of one Cloud Storage bucket.Read-onlyGet Bucket
Get the settings of one Cloud Storage bucket. Returns its location, storageClass, versioning, lifecycle, iamConfiguration, labels and metageneration. Use this when you know the bucket name. Use googlecloudstorage_buckets_list to find buckets.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
projectionstring- Set to full to include ACLs in the response, or noAcl to leave them out. Example: noAclone of
fullnoAcl
googlecloudstorage_bucket_iam_policy_getGet the IAM policy of a Cloud Storage bucket.Read-onlyGet Bucket IAM Policy
Get the IAM policy of a Cloud Storage bucket. Returns the policy's bindings (role and members), etag and version. Use this to see who has access to a bucket. Use googlecloudstorage_bucket_permissions_test to check the caller's own access.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
options_requested_policy_versioninteger- Policy version to return. Use 3 to see conditional role bindings. Example: 3
googlecloudstorage_bucket_permissions_testCheck which of the given permissions the connected user has on a Cloud Storage bucket.Read-onlyTest Bucket Permissions
Check which of the given permissions the connected user has on a Cloud Storage bucket. Returns the subset of the permissions that are granted. Use this before a write to confirm access. Use googlecloudstorage_bucket_iam_policy_get to see the whole policy.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
permissionsarrayrequired- Permissions to check. Example: ["storage.objects.list", "storage.objects.create"]
googlecloudstorage_buckets_listList the Cloud Storage buckets in a Google Cloud project.Read-onlyList Buckets
List the Cloud Storage buckets in a Google Cloud project. Returns each bucket's name, location, storageClass, timeCreated and labels, plus nextPageToken when there are more. Use this to find a bucket. Use googlecloudstorage_bucket_get for one bucket's full settings.
Inputs
projectstringrequired- Google Cloud project ID or number. Example: my-project-123
max_resultsinteger- Maximum number of buckets per page. Example: 100
page_tokenstring- nextPageToken from the previous page. Example: CgdyZXBvcnRz
prefixstring- Only return buckets whose names start with this text. Example: acme-
googlecloudstorage_folders_listList the folders of a Cloud Storage bucket that has hierarchical namespace enabled.Read-onlyList Folders
List the folders of a Cloud Storage bucket that has hierarchical namespace enabled. Returns each folder's name, createTime and metageneration, plus nextPageToken. Use this only for hierarchical-namespace buckets. For other buckets, use googlecloudstorage_objects_list with delimiter /.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
page_sizeinteger- Maximum number of folders per page. Example: 100
page_tokenstring- nextPageToken from the previous page. Example: CgdyZXBvcnRz
prefixstring- Only list folders whose names start with this text. Example: reports/
googlecloudstorage_notifications_listList the Pub/Sub notification configurations of a Cloud Storage bucket.Read-onlyList Notifications
List the Pub/Sub notification configurations of a Cloud Storage bucket. Returns each configuration's id, topic, event_types, payload_format and object_name_prefix. Use this to see where bucket change events are sent.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
googlecloudstorage_object_downloadDownload the content of an object in a Cloud Storage bucket.Read-onlyDownload Object
Download the content of an object in a Cloud Storage bucket. Returns the raw file content as the response body, not JSON; text files such as CSV, JSON or logs come back as text. Use this to read a file. Use googlecloudstorage_object_get for metadata only. Large or binary files may not be usable in the response.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
objectstringrequired- Full name of the object inside the bucket. URL-encode the name: write / as %2F and a space as %20. Example: reports%2F2026%2Fq1.csv for reports/2026/q1.csv
generationstring- Specific version (generation number) of the object. Omit it for the live version. Example: 1700000000000000
googlecloudstorage_object_getGet the metadata of one object in a Cloud Storage bucket.Read-onlyGet Object Metadata
Get the metadata of one object in a Cloud Storage bucket. Returns its name, size, contentType, md5Hash, crc32c, generation, metageneration, timestamps and custom metadata, but not the file content. Use this to inspect a file. Use googlecloudstorage_object_download to read its content.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
objectstringrequired- Full name of the object inside the bucket. URL-encode the name: write / as %2F and a space as %20. Example: reports%2F2026%2Fq1.csv for reports/2026/q1.csv
generationstring- Specific version (generation number) of the object. Omit it for the live version. Example: 1700000000000000
googlecloudstorage_objects_listList the objects (files) in a Cloud Storage bucket, optionally under a folder-like prefix.Read-onlyList Objects
List the objects (files) in a Cloud Storage bucket, optionally under a folder-like prefix. Returns each object's name, size, contentType, updated time, generation and md5Hash, plus prefixes (sub-folders, when delimiter is /) and nextPageToken. Use this to browse a bucket. Use googlecloudstorage_object_get for one object's metadata.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
delimiterstring- Set to / to list one folder level: deeper names are returned in prefixes instead of items. Example: /
match_globstring- Glob pattern the object names must match. Example: **.csv
max_resultsinteger- Maximum number of objects per page. Example: 100
page_tokenstring- nextPageToken from the previous page. Example: CgdyZXBvcnRz
prefixstring- Only list objects whose names start with this text, such as a folder path. Not URL-encoded. Example: reports/2026/
soft_deletedboolean- List only soft-deleted objects, which googlecloudstorage_object_restore can bring back. Cannot be combined with versions. Example: false
versionsboolean- Also list old (noncurrent) versions of objects. Example: false
googlecloudstorage_service_account_getGet the email of the Cloud Storage service agent for a Google Cloud project.Read-onlyGet Service Agent
Get the email of the Cloud Storage service agent for a Google Cloud project. Returns email_address. Use this to grant the service agent access, for example the Pub/Sub Publisher role before googlecloudstorage_notification_create.
Inputs
projectstringrequired- Google Cloud project ID or number. Example: my-project-123
googlecloudstorage_bucket_createCreate a Cloud Storage bucket in a Google Cloud project.WriteCreate Bucket
Create a Cloud Storage bucket in a Google Cloud project. Returns the new bucket resource. Use this to add a bucket. Bucket names are globally unique; the call fails with 409 if the name is taken.
Inputs
namestringrequired- Globally unique bucket name: 3 to 63 lowercase letters, digits, dashes, underscores and dots. Example: acme-reports-2026
projectstringrequired- Google Cloud project ID or number. Example: my-project-123
labelsobject- Key-value labels for the bucket. Keys and values are lowercase. Example: {"team": "finance"}
lifecycle_rulesarray- Lifecycle rules that replace the bucket's current rules. Each rule has an action (Delete, SetStorageClass or AbortIncompleteMultipartUpload) and a condition, such as age in days. Example: [{"action": {"type": "Delete"}, "condition": {"age": 365}}]
locationstring- Where the bucket's data lives: a region, dual-region or multi-region. It cannot be changed later. Defaults to US. Example: EUROPE-WEST1
storage_classstring- Default storage class for new objects: STANDARD, NEARLINE, COLDLINE or ARCHIVE. Example: STANDARDone of
STANDARDNEARLINECOLDLINEARCHIVE uniform_bucket_level_accessboolean- Control access with IAM only, turning off per-object ACLs. Example: true
versioning_enabledboolean- Keep old versions of objects when they are overwritten or deleted. Example: true
googlecloudstorage_bucket_updateChange settings of a Cloud Storage bucket: storage class, labels, versioning, uniform access or lifecycle rules.WriteUpdate Bucket
Change settings of a Cloud Storage bucket: storage class, labels, versioning, uniform access or lifecycle rules. Returns the updated bucket. Use this to change a bucket. Only the fields you pass are changed; labels you pass replace the matching keys.
- Idempotent
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
labelsobject- Key-value labels for the bucket. Keys and values are lowercase. Example: {"team": "finance"}
lifecycle_rulesarray- Lifecycle rules that replace the bucket's current rules. Each rule has an action (Delete, SetStorageClass or AbortIncompleteMultipartUpload) and a condition, such as age in days. Example: [{"action": {"type": "Delete"}, "condition": {"age": 365}}]
storage_classstring- Default storage class for new objects: STANDARD, NEARLINE, COLDLINE or ARCHIVE. Example: STANDARDone of
STANDARDNEARLINECOLDLINEARCHIVE uniform_bucket_level_accessboolean- Control access with IAM only, turning off per-object ACLs. Example: true
versioning_enabledboolean- Keep old versions of objects when they are overwritten or deleted. Example: true
googlecloudstorage_folder_createCreate a folder in a Cloud Storage bucket that has hierarchical namespace enabled.WriteCreate Folder
Create a folder in a Cloud Storage bucket that has hierarchical namespace enabled. Returns the new folder. Use this only for hierarchical-namespace buckets; in other buckets folders are just name prefixes.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
namestringrequired- Folder name, ending with /. Example: reports/2027/
recursiveboolean- Also create missing parent folders. Example: true
googlecloudstorage_notification_createSend change events from a Cloud Storage bucket to a Pub/Sub topic.WriteCreate Notification
Send change events from a Cloud Storage bucket to a Pub/Sub topic. Returns the new notification configuration with its id. Use this to get notified when objects are created, deleted or updated. The bucket's Cloud Storage service agent (from googlecloudstorage_service_account_get) needs the Pub/Sub Publisher role on the topic.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
payload_formatstringrequired- Message content: JSON_API_V1 (object metadata as JSON) or NONE. Example: JSON_API_V1one of
JSON_API_V1NONE topicstringrequired- Pub/Sub topic to publish to, in the form //pubsub.googleapis.com/projects/PROJECT/topics/TOPIC. Example: //pubsub.googleapis.com/projects/my-project-123/topics/gcs-events
event_typesarray- Only send these events: OBJECT_FINALIZE, OBJECT_METADATA_UPDATE, OBJECT_DELETE or OBJECT_ARCHIVE. Omit to send all. Example: ["OBJECT_FINALIZE"]
object_name_prefixstring- Only send events for objects whose names start with this text. Example: uploads/
googlecloudstorage_object_composeConcatenate up to 32 objects in the same bucket into one new object.WriteCompose Objects
Concatenate up to 32 objects in the same bucket into one new object. Returns the metadata of the composed object. Use this to join file parts, such as log chunks, into one file.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
destination_objectstringrequired- Name of the object to create. URL-encode the name: write / as %2F and a space as %20. Example: logs%2Fday.log
source_object_namesarrayrequired- Names of the objects to join, in order, all in the same bucket. Plain names, not URL-encoded. Example: ["logs/part-1.log", "logs/part-2.log"]
content_typestring- MIME type of the joined object. Example: text/plain
googlecloudstorage_object_copyCopy an object to a new name, in the same bucket or another bucket.WriteCopy Object
Copy an object to a new name, in the same bucket or another bucket. Returns the metadata of the new object. Use this to duplicate a file. Use googlecloudstorage_object_move to rename within a bucket.
Inputs
destination_bucketstringrequired- Bucket to copy into. Example: acme-archive
destination_objectstringrequired- Name for the copy. URL-encode the name: write / as %2F and a space as %20. Example: 2026%2Fq1.csv
source_bucketstringrequired- Bucket that holds the object to copy. Example: acme-reports
source_objectstringrequired- Name of the object to copy. URL-encode the name: write / as %2F and a space as %20. Example: reports%2Fq1.csv
if_generation_matchstring- Only make the change if the object's current generation matches this value. Use 0 to only write when the destination does not exist yet. Example: 0
googlecloudstorage_object_moveRename (move) an object within a Cloud Storage bucket.WriteMove Object
Rename (move) an object within a Cloud Storage bucket. Returns the metadata of the object under its new name. Use this to rename or move a file inside one bucket. Use googlecloudstorage_object_copy to copy to another bucket.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
destination_objectstringrequired- New name of the object. URL-encode the name: write / as %2F and a space as %20. Example: reports%2Fq1.csv
source_objectstringrequired- Current name of the object. URL-encode the name: write / as %2F and a space as %20. Example: inbox%2Fq1.csv
if_generation_matchstring- Only make the change if the object's current generation matches this value. Use 0 to only write when the destination does not exist yet. Example: 0
googlecloudstorage_object_restoreRestore a soft-deleted object in a Cloud Storage bucket.WriteRestore Object
Restore a soft-deleted object in a Cloud Storage bucket. Returns the metadata of the restored object. Use this to undo a delete within the bucket's soft-delete window. List soft-deleted objects with googlecloudstorage_objects_list to get the generation.
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
generationstringrequired- Generation of the soft-deleted object to restore. Example: 1700000000000000
objectstringrequired- Full name of the object inside the bucket. URL-encode the name: write / as %2F and a space as %20. Example: reports%2F2026%2Fq1.csv for reports/2026/q1.csv
googlecloudstorage_object_updateChange the metadata of an object in a Cloud Storage bucket, such as its content type, cache control or custom metadata.WriteUpdate Object Metadata
Change the metadata of an object in a Cloud Storage bucket, such as its content type, cache control or custom metadata. Returns the updated object metadata. Use this to change how a file is served or tagged. The file content is not changed.
- Idempotent
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
objectstringrequired- Full name of the object inside the bucket. URL-encode the name: write / as %2F and a space as %20. Example: reports%2F2026%2Fq1.csv for reports/2026/q1.csv
cache_controlstring- Cache-Control header served with the object. Example: public, max-age=3600
content_dispositionstring- Content-Disposition header served with the object. Example: attachment; filename="q1.csv"
content_typestring- MIME type of the object. Example: text/csv
metadataobject- Custom key-value metadata to set on the object. Set a key to null to remove it. Example: {"owner": "finance"}
googlecloudstorage_bucket_deleteDelete an empty Cloud Storage bucket.DestructiveDelete Bucket
Delete an empty Cloud Storage bucket. Returns no content on success; fails with 409 if the bucket still holds objects. Use this to remove a bucket after deleting its objects with googlecloudstorage_object_delete.
- Idempotent
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
googlecloudstorage_notification_deleteDelete a Pub/Sub notification configuration from a Cloud Storage bucket.DestructiveDelete Notification
Delete a Pub/Sub notification configuration from a Cloud Storage bucket. Returns no content on success. The Pub/Sub topic is not deleted. Use this to stop sending bucket events to a topic.
- Idempotent
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
notification_idstringrequired- ID of the notification configuration. Get it from googlecloudstorage_notifications_list. Example: 5
googlecloudstorage_object_deleteDelete an object from a Cloud Storage bucket.DestructiveDelete Object
Delete an object from a Cloud Storage bucket. Returns no content on success. If the bucket has versioning or soft delete, the object can still be restored. Use this to remove a file. Use googlecloudstorage_object_restore to bring back a soft-deleted object.
- Idempotent
Inputs
bucketstringrequired- Name of the bucket, without gs://. Example: acme-reports
objectstringrequired- Full name of the object inside the bucket. URL-encode the name: write / as %2F and a space as %20. Example: reports%2F2026%2Fq1.csv for reports/2026/q1.csv
generationstring- Specific version (generation number) of the object. Omit it for the live version. Example: 1700000000000000
No tools match.