Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Google Cloud Storage

Scalekit connector
Open markdown

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 app
Your own Google Cloud Storage app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. 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_name your code passes. See Configure connections.

  4. 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.

  5. 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.actions
    const connector = 'googlecloudstorage'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'googlecloudstorage_bucket_get',
    toolInput: { bucket: 'YOUR_BUCKET' },
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • googlecloudstorage_bucket_getGet the settings of one Cloud Storage bucket.Read-only

    Get 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-only

    Get 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-only

    Test 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-only

    List 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-only

    List 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-only

    List 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-only

    Download 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-only

    Get 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