Integration guide

Google Drive integration for AI agents and workflows

Swfte Studio has a Google Drive node. Its shipped data shows one action, list, used twice: once for files and once for folders, each with a query string and a limit. A workflow can inventory a Drive and report on it, but the data shows no action that reads a file’s contents, uploads or shares.

That makes Drive a good place to start with governed automation, because the safest design is also the one the data supports: list, count, compare and report. Drive has no entry of its own in the integration catalogue, which lists a single Google entry, and no server in the MCP tool list. The node appears in the shipped workflow templates, so this page is about the workflow node.

Built in Swfte Studio, run as a governed workflow, and held to the same rules as any governed agent.

Google Drive at a glance

Catalogue
No entry of its own
Actions in the shipped data
2 (2 read, 0 write)
Credential type shown
googleDriveOAuth2Api
MCP server
None in the MCP tool list
Shipped templates that use it
Google Drive Workflow

What you can do with Google Drive

Every action below is read from a node in a shipped workflow template. Nothing is listed that the data does not show.

Google Drive actions in the shipped workflow templates
ActionTypeOperationWhat the data shows
List FilesReadlistLists files. The shipped template asks for twenty and excludes folders with a query on the item type.
List FoldersReadlistThe same list action with a different query, which keeps only folders, and a limit of ten.

One action, two queries, both reads. Nothing in the shipped data downloads, uploads, creates a folder or changes sharing, although the template’s description mentions creating a folder and uploading a file. Do not design around those until you have checked the node in Studio.

There is no Drive event in the data, such as a file being added to a folder: <Google Drive trigger events - founder to fill>.

Drive access is mostly about scope and sharing

Folders in Drive are shared with people and groups, and files inherit what their folder allows. The sensible first question for a workflow is therefore which folders it should see at all. A listing of names is lower risk than reading content, but names alone can reveal a lot: a file called a redundancy plan or a salary review tells a reader something without ever being opened.

The shipped template uses a query string to separate files from folders. One query keeps everything that is not a folder, another keeps only folders. The same mechanism is how you narrow a listing to one area of Drive, so treat the query as part of the workflow’s permissions and not as a detail.

How to connect Google Drive

The shipped template names the credential type googleDriveOAuth2Api, an OAuth 2 connection to a Google account.

  1. 01

    Choose the account

    Connect a service or shared account that owns only the folders the workflow is for. Files in a personal Drive tend to be shared in ways nobody remembers.

  2. 02

    Agree the query first

    Decide the query before the workflow exists, and have the owner of that area of Drive agree it. It defines what the workflow can see.

  3. 03

    Run the listing alone

    Check the results against what you expected. A surprising file name is a finding worth acting on.

  4. 04

    Approve scope changes

    Any change to the query goes through the same approval as the first version.

Three governed Google Drive workflows to build in Studio

Each has a label. A starting point builds on a shipped template, which is an integration test with no approval step. A design is intent only.

Drive hygiene report

Starting point

Builds on the shipped template “Google Drive Workflow” (5 nodes), which you can find in the template library.

Count the files and folders in an area of Drive and report naming problems to its owner.

  1. List files with the item-type query.
  2. List folders with the folder query.
  3. A code node counts both and flags names that break the team’s convention.
  4. The report goes to the folder owner as output.

Where the approval sits. Nothing here writes to Drive, so no approval is needed. The query is the control.

Scope confirmation before deeper automation

Designed

Make the owner of a Drive area confirm what a later workflow may see.

  1. List the folders in the area with the list action.
  2. A human-input step shows the owner the folder names, with approve and reject branches.
  3. On approval, the confirmed list is passed on as the input that later workflows read their scope from.
  4. On rejection, the run ends there and the owner’s reason is saved with it.

Where the approval sits. This workflow is the approval. Later workflows read the confirmed scope and do not choose one for themselves.

Onboarding folder check

Designed

Check that a new starter’s folder has the sections the team expects.

  1. List the folders in the starter’s area.
  2. A code node compares the names with the expected list.
  3. Gaps go to the hiring manager in a human-input step.
  4. The outcome is passed to the people team as output.

Where the approval sits. Approval confirms the manager has seen the gaps. Creating the missing folders is not in the shipped data, so a person does it.

Shipped template
A governed template with its approval step already in it ships in the platform.
Starting point
A shipped template runs the same actions. It is an integration test with no approval step, so you add the gate.
Designed
Design intent. It uses the actions listed above plus generic nodes, and nothing has been built as a template.

Approvals and records for Google Drive

A listing is a read, but file and folder names are information, so scope is the main control.

Needs a person’s approval

  • Any change to the query that widens what is listed.
  • Connecting a personal Drive instead of a shared or service account.
  • Sending file names to a model when they might reveal personal or commercial detail.

Can run without one

  • Listing the folders in an area the owner has already approved.
  • Counting files for a hygiene report that stays inside the team.

What is recorded

  • Both list actions, with the run each belongs to.
  • The owner’s approval of a scope, and when it was given.
  • Any policy decision, such as a deny on a folder outside the agreed area.

Drive’s sharing model stays in force and Swfte does not widen it. What Swfte adds is a pause, a policy check and a record for each run.

A policy step in a design below describes the intent. The policy engine acts only on runs that have a policy attached, and a self-serve way to author policies is not something we describe as built.

Swfte’s own security position and any attestations are on the trust page. How approvals, policy and records fit together is on the governed agents page.

Comparing tools for Google Drive work

These comparison pages are dated and sourced. Each says who should pick the other tool.

  • Glean alternatives

    Search across Drive and other tools is Glean’s focus. The comparison covers when that suits you better than a workflow builder.

  • Zapier alternatives

    The Zapier comparison covers when a simple file trigger and action is all you need.

  • Best automation platforms

    How automation platforms compare on governance, approvals and records, with the method shown.

Google Drive questions

Can Swfte read the contents of a Google Drive file?

Not with the actions in the shipped data, which list files and folders. The data does not show a download or read-content action. Check the node in Studio before you design around one.

Is there a Google Drive MCP server in Swfte?

No. The MCP tool list has eight entries and Drive is not one of them. You reach Drive through the Studio workflow node.

How do I keep an agent out of private folders?

Connect an account that cannot see them, narrow the query, and have the folder owner approve the scope. A workflow cannot list what its account cannot see, so the account is the strongest limit.

Can a workflow upload or share a file?

The data does not show it. The shipped template’s description says it can create a folder and upload a file, but its nodes only list. Treat uploads and sharing changes as unproven until you have run them.

What does the run record show for a Drive listing?

The run ledger records the policy decisions, approvals and actions for the run, so you can see which list actions ran and who approved the scope. It records what the workflow did and does not replace Drive’s own activity history.

Build a governed Google Drive workflow

Begin with a read-only workflow on a test account, then add one write with an approval in front of it.

Build this in Studio

Describe what you need in plain language. Studio builds the agents and workflows, and you keep every version.