Skip to main content
Plugin ID: gcp | Auth: OAuth2 (with PKCE) | Scopes: compute.readonly, devstorage.read_only, bigquery.readonly, iam.readonly, cloudplatformprojects.readonly
The GCP plugin uses a dedicated gcp OAuth provider (separate from the google provider used by Google Workspace) to keep cloud-platform scopes isolated.

Tools

gcp.projects.list

Name: List Projects List GCP projects accessible to the authenticated user. Input:
ParameterTypeRequiredDefaultDescription
filterstringNoFilter expression (e.g. "name:my-project")
pageSizeintegerNo50Max results
pageTokenstringNoPagination token
Output:
{
  "projects": [
    { "projectId": "my-project-123", "name": "My Project", "projectNumber": "123456789", "lifecycleState": "ACTIVE" }
  ],
  "nextPageToken": null
}

gcp.compute.instances.list

Name: List VM Instances List Compute Engine VM instances in a project and zone. Input:
ParameterTypeRequiredDefaultDescription
projectstringYesGCP project ID
zonestringYesCompute zone (e.g. "us-central1-a")
maxResultsintegerNo50Max results
pageTokenstringNoPagination token
Output:
{
  "instances": [
    { "id": "123", "name": "web-server-1", "status": "RUNNING", "machineType": "e2-medium", "zone": "us-central1-a" }
  ],
  "nextPageToken": null
}

gcp.compute.instances.get

Name: Get VM Instance Get details of a specific Compute Engine VM instance. Input:
ParameterTypeRequiredDescription
projectstringYesGCP project ID
zonestringYesCompute zone
instancestringYesInstance name
Output:
{
  "id": "123", "name": "web-server-1", "status": "RUNNING", "machineType": "e2-medium",
  "networkInterfaces": [{}], "disks": [{}], "creationTimestamp": "2026-01-01T00:00:00Z"
}

gcp.compute.instances.start

Name: Start VM Instance | Destructive: Yes Start a stopped Compute Engine VM instance. Returns a long-running operation. Requires user approval. Input:
ParameterTypeRequiredDescription
projectstringYesGCP project ID
zonestringYesCompute zone
instancestringYesInstance name
Output:
{ "operation": "op-123", "status": "RUNNING", "targetLink": "https://..." }

gcp.compute.instances.stop

Name: Stop VM Instance | Destructive: Yes Stop a running Compute Engine VM instance. Requires user approval. Input:
ParameterTypeRequiredDescription
projectstringYesGCP project ID
zonestringYesCompute zone
instancestringYesInstance name
Output:
{ "operation": "op-456", "status": "RUNNING", "targetLink": "https://..." }

gcp.storage.buckets.list

Name: List Buckets List Cloud Storage buckets in a project. Input:
ParameterTypeRequiredDefaultDescription
projectstringYesGCP project ID
maxResultsintegerNo50Max results
pageTokenstringNoPagination token
Output:
{
  "buckets": [
    { "id": "my-bucket", "name": "my-bucket", "location": "US", "storageClass": "STANDARD", "timeCreated": "2026-01-01T00:00:00Z" }
  ],
  "nextPageToken": null
}

gcp.storage.objects.list

Name: List Objects List objects in a Cloud Storage bucket. Input:
ParameterTypeRequiredDefaultDescription
bucketstringYesBucket name
prefixstringNoObject name prefix filter
delimiterstringNoDelimiter for hierarchy (usually "/")
maxResultsintegerNo100Max results
pageTokenstringNoPagination token
Output:
{
  "objects": [
    { "name": "data/file.csv", "size": "1024", "contentType": "text/csv", "updated": "2026-04-01T00:00:00Z" }
  ],
  "prefixes": ["data/subdir/"],
  "nextPageToken": null
}

gcp.storage.objects.get_metadata

Name: Get Object Metadata Get metadata for a Cloud Storage object (does not download the content). Input:
ParameterTypeRequiredDescription
bucketstringYesBucket name
objectstringYesObject name (path within bucket)
Output:
{ "name": "data/file.csv", "bucket": "my-bucket", "size": "1024", "contentType": "text/csv", "md5Hash": "abc123", "updated": "2026-04-01T00:00:00Z", "metadata": null }

gcp.bigquery.datasets.list

Name: List Datasets List BigQuery datasets in a project. Input:
ParameterTypeRequiredDefaultDescription
projectstringYesGCP project ID
maxResultsintegerNo50Max results
pageTokenstringNoPagination token
Output:
{
  "datasets": [
    { "datasetId": "analytics", "projectId": "my-project", "location": "US" }
  ],
  "nextPageToken": null
}

gcp.bigquery.tables.list

Name: List Tables List tables in a BigQuery dataset. Input:
ParameterTypeRequiredDefaultDescription
projectstringYesGCP project ID
datasetIdstringYesBigQuery dataset ID
maxResultsintegerNo50Max results
pageTokenstringNoPagination token
Output:
{
  "tables": [
    { "tableId": "events", "type": "TABLE", "creationTime": "1700000000000" }
  ],
  "nextPageToken": null
}

gcp.bigquery.query

Name: Run Query Run a read-only SQL query against BigQuery. Input:
ParameterTypeRequiredDefaultDescription
projectstringYesGCP project ID
querystringYesStandard SQL query
maxResultsintegerNo100Max rows
useLegacySqlbooleanNofalseUse legacy SQL syntax
Output:
{
  "totalRows": "42",
  "schema": [{ "name": "user_id", "type": "STRING" }],
  "rows": [["user_123"]],
  "jobComplete": true
}

gcp.iam.service_accounts.list

Name: List Service Accounts List service accounts in a GCP project. Input:
ParameterTypeRequiredDefaultDescription
projectstringYesGCP project ID
pageSizeintegerNo50Max results
pageTokenstringNoPagination token
Output:
{
  "accounts": [
    { "email": "sa@my-project.iam.gserviceaccount.com", "displayName": "My SA", "disabled": false, "uniqueId": "123" }
  ],
  "nextPageToken": null
}