# Google Drive — Pipedream Connect

> Google Drive is a file storage and synchronization service which allows you to create and share your work online, and access your documents from anywhere.

- API slug: `google_drive` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: File Storage
- Website: https://drive.google.com/
- Managed OAuth scopes: `https://www.googleapis.com/auth/drive` · `email` · `profile` · `openid`
- This page (HTML): https://pipedream.com/apps/google-drive
- Tools: 50 actions · 17 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: google_drive`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "google_drive",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Comment:
const result = await mcp.callTool({
  name: "google_drive-add-comment",
  arguments: {
    drive: "Drive",
    fileId: "File",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Google Drive endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://www.googleapis.com/drive/v3/about?fields=user

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vZHJpdmUvdjMvYWJvdXQ_ZmllbGRzPXVzZXI?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "google_drive-add-comment",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_drive: { authProvisionId: "apn_xxxxxxx" },
    drive: "Drive",
    fileId: "File",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (50)

### `google_drive-add-comment` — Add Comment (Write)

Add an unanchored comment to a Google Doc (general feedback, no text highlighting). See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/add-comment.md

### `google_drive-copy-file` — Copy File (Write)

Create a copy of the specified file. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/copy-file.md

### `google_drive-create-folder` — Create Folder (Write)

Create a new empty folder. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/create-folder.md

### `google_drive-create-file-from-template` — Create New File From Template (Write)

Create a new Google Docs file from a template. Optionally include placeholders in the template document that will get replaced from this action. See documentation

Full schema: https://pipedream.com/apps/google-drive/actions/create-file-from-template.md

### `google_drive-create-file-from-text` — Create New File From Text (Write)

Create a new file from plain text. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/create-file-from-text.md

### `google_drive-create-shared-drive` — Create Shared Drive (Write)

Create a new shared drive. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/create-shared-drive.md

### `google_drive-create-text-file` — Create Text File (Write)

Create a new Google Doc from text content in Google Drive. The file is created as a Google Docs document, which can be viewed and edited in the browser. Use this when the user asks to create a document, write a file, or save text to Drive. To place the file in a specific folder, pass the parentId…

Full schema: https://pipedream.com/apps/google-drive/actions/create-text-file.md

### `google_drive-delete-comment` — Delete Comment (Write)

Delete a specific comment (Requires ownership or permissions). See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/delete-comment.md

### `google_drive-delete-file` — Delete File (Write)

Permanently delete a file or folder without moving it to the trash. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/delete-file.md

### `google_drive-delete-reply` — Delete Reply (Write)

Delete a reply on a specific comment. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/delete-reply.md

### `google_drive-delete-shared-drive` — Delete Shared Drive (Write)

Delete a shared drive without any content. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/delete-shared-drive.md

### `google_drive-download-file` — Download File (Write)

Download one or more files from Google Drive to the /tmp directory or return their contents as buffers. Select multiple files to download a batch in a single run. Use to fetch a file's contents for processing in downstream steps — e.g., parsing a CSV, extracting text from a PDF, or re-uploading to…

Full schema: https://pipedream.com/apps/google-drive/actions/download-file.md

### `google_drive-find-file` — Find File (Read-only)

Search for a specific file by name. The Search Name field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like & or '. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/find-file.md

### `google_drive-find-folder` — Find Folder (Read-only)

Search for a specific folder by name. The Search Name field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like & or '. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/find-folder.md

### `google_drive-find-forms` — Find Forms (Read-only)

List Google Form documents or search for a Form by name. The Search Name field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like & or '. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/find-forms.md

### `google_drive-find-spreadsheets` — Find Spreadsheets (Read-only)

Search for a specific spreadsheet by name. The Search Name field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like & or '. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/find-spreadsheets.md

### `google_drive-get-comment` — Get Comment By ID (Read-only)

Get comment by ID on a specific file. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/get-comment.md

### `google_drive-get-current-user` — Get Current User (Read-only)

Retrieve Google Drive account metadata for the authenticated user via about.get, including display name, email, permission ID, and storage quota. Useful when flows or agents need to confirm the active Google identity or understand available storage. See the documentation.

Full schema: https://pipedream.com/apps/google-drive/actions/get-current-user.md

### `google_drive-get-file` — Get File (Read-only)

Get full metadata for a file or folder by its ID. Returns name, MIME type, size, parent folders, sharing permissions, web links, creation/modification dates, and more. Use Search Files first to find the file ID if you only have the file name. By default returns all fields. Pass specific field names…

Full schema: https://pipedream.com/apps/google-drive/actions/get-file.md

### `google_drive-get-file-by-id` — Get File By ID (Read-only)

Get info on a specific file. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/get-file-by-id.md

### `google_drive-get-folder-id-for-path` — Get Folder ID for a Path (Read-only)

Retrieve a folderId for a path. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/get-folder-id-for-path.md

### `google_drive-get-reply` — Get Reply By ID (Read-only)

Get reply by ID on a specific comment. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/get-reply.md

### `google_drive-get-shared-drive` — Get Shared Drive (Read-only)

Get metadata for one or all shared drives. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/get-shared-drive.md

### `google_drive-get-user-details` — Get User Details (Read-only)

Retrieve the authenticated user's Google Drive identity and storage quota. Returns display name, email address, permission ID, and storage usage/limits. Use this tool when the user asks 'who am I?' or needs their identity for owner-based queries. When the user says 'my files' or 'my documents'…

Full schema: https://pipedream.com/apps/google-drive/actions/get-user-details.md

### `google_drive-is-folder-ancestor` — Is Folder Ancestor (Read-only)

Check if a specific folder is anywhere in the parent hierarchy of a file or folder. See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/is-folder-ancestor.md

### `google_drive-list-access-proposals` — List Access Proposals (Read-only)

List access proposals for a file or folder. See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/list-access-proposals.md

### `google_drive-list-comments` — List Comments (Read-only)

List the comments on a file, including each comment's author, plain text and HTML content, the file text it is anchored to, whether it is resolved, and its full reply thread. Use Find File first to resolve a file's name to its ID. See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/list-comments.md

### `google_drive-list-files` — List Files (Read-only)

List files from a specific folder. Set Max Results to cap how many files are returned per run, then pass the returned nextPageToken back in as Page Token on the next run to page through a large folder in fixed-size batches. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/list-files.md

### `google_drive-list-mime-type-options` — List Mime Type Options (Read-only)

Retrieves available options for the Mime Type field.

Full schema: https://pipedream.com/apps/google-drive/actions/list-mime-type-options.md

### `google_drive-list-permissions` — List Permissions (Read-only)

List sharing permissions on a file or folder in Google Drive. Returns each permission's ID, type (user/group/domain/anyone), role (owner/writer/commenter/reader), and email address. Use Search Files first to find the file ID by name. Use this tool when the user asks 'who has access to this file?'…

Full schema: https://pipedream.com/apps/google-drive/actions/list-permissions.md

### `google_drive-list-replies` — List Replies (Read-only)

List replies to a specific comment. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/list-replies.md

### `google_drive-list-shared-drives` — List Shared Drives (Read-only)

List shared drives accessible to the authenticated user. Returns drive IDs, names, and metadata for each shared drive. Use this when the user asks about their shared drives or needs to scope a search to a specific drive. Pass a drive ID to Search Files driveId parameter to search within a specific…

Full schema: https://pipedream.com/apps/google-drive/actions/list-shared-drives.md

### `google_drive-list-theme-id-options` — List Theme ID Options (Read-only)

Retrieves available options for the Theme ID field.

Full schema: https://pipedream.com/apps/google-drive/actions/list-theme-id-options.md

### `google_drive-move-file` — Move File (Write)

Move a file from one folder to another. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/move-file.md

### `google_drive-move-file-to-trash` — Move File to Trash (Write)

Move a file or folder to trash. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/move-file-to-trash.md

### `google_drive-remove-file-sharing-permission` — Remove File Sharing Permission (Write)

Remove a sharing permission from the sharing preferences of a file or folder. See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/remove-file-sharing-permission.md

### `google_drive-remove-sharing` — Remove Sharing (Write)

Remove a sharing permission from a file or folder in Google Drive. This revokes access for the specified permission. Use List Permissions first to find the permission ID to remove. The owner permission cannot be removed. Use Search Files to find the file ID by name if needed. See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/remove-sharing.md

### `google_drive-reply-to-comment` — Reply to Comment (Write)

Add a reply to an existing comment. See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/reply-to-comment.md

### `google_drive-resolve-access-proposal` — Resolve Access Proposals (Write)

Accept or deny a request for access to a file or folder in Google Drive. See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/resolve-access-proposal.md

### `google_drive-resolve-comment` — Resolve Comment (Write)

Mark a comment as resolved. See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/resolve-comment.md

### `google_drive-search-files` — Search Files (Read-only)

Search for files and folders in Google Drive using the Drive query language. This is the primary tool for finding files, folders, spreadsheets, forms, and any other Drive item. Returns matching files with their IDs, names, MIME types, and parent folder IDs.

Full schema: https://pipedream.com/apps/google-drive/actions/search-files.md

### `google_drive-search-shared-drives` — Search for Shared Drives (Read-only)

Search for shared drives with query options. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/search-shared-drives.md

### `google_drive-share-file` — Share File (Write)

Share a file or folder in Google Drive by creating a sharing permission. Supports sharing with a specific user, a group, an entire domain, or anyone with the link. Use Search Files first to find the file ID by name.

Full schema: https://pipedream.com/apps/google-drive/actions/share-file.md

### `google_drive-add-file-sharing-preference` — Share File or Folder (Write)

Add a sharing permission to the sharing preferences of a file or folder and provide a sharing URL. See the documentation

Full schema: https://pipedream.com/apps/google-drive/actions/add-file-sharing-preference.md

### `google_drive-trash-file` — Trash File (Write)

Move a file or folder to the trash in Google Drive. This is a reversible operation — the file can be restored from trash within 30 days. Use Search Files first to find the file ID by name. Use this instead of permanent deletion as the safer default. To find trashed files, use Search Files with…

Full schema: https://pipedream.com/apps/google-drive/actions/trash-file.md

### `google_drive-update-comment` — Update Comment (Write)

Update the content of a specific comment. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/update-comment.md

### `google_drive-update-file` — Update File (Write)

Update a file's metadata and/or content. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/update-file.md

### `google_drive-update-reply` — Update Reply (Write)

Update a reply on a specific comment. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/update-reply.md

### `google_drive-update-shared-drive` — Update Shared Drive (Write)

Update an existing shared drive. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/update-shared-drive.md

### `google_drive-upload-file` — Upload File (Write)

Upload a file to Google Drive. See the documentation for more information

Full schema: https://pipedream.com/apps/google-drive/actions/upload-file.md

## Triggers (17)

### `google_drive-changes-to-files-in-drive` — Changes to Files in Drive (Polling)

Emit new event when a change is made to one of the specified files. See the documentation

Full schema: https://pipedream.com/apps/google-drive/triggers/changes-to-files-in-drive.md

### `google_drive-changes-to-specific-files` — Changes to Specific Files (Polling)

Watches for changes to specific files, emitting an event when a change is made to one of those files. To watch for changes to shared drive files, use the Changes to Specific Files (Shared Drive) source instead.

Full schema: https://pipedream.com/apps/google-drive/triggers/changes-to-specific-files.md

### `google_drive-changes-to-specific-files-shared-drive` — Changes to Specific Files (Shared Drive) (Polling)

Watches for changes to specific files in a shared drive, emitting an event when a change is made to one of those files

Full schema: https://pipedream.com/apps/google-drive/triggers/changes-to-specific-files-shared-drive.md

### `google_drive-new-access-proposal` — New Access Proposal (Polling)

Emit new event when a new access proposal is requested in Google Drive

Full schema: https://pipedream.com/apps/google-drive/triggers/new-access-proposal.md

### `google_drive-new-files-instant` — New Files (Instant) (Polling)

Emit new event when a new file is added in your linked Google Drive

Full schema: https://pipedream.com/apps/google-drive/triggers/new-files-instant.md

### `google_drive-new-files-instant-polling` — New Files (Polling) (Polling)

Emit new event when a new file is added in your linked Google Drive

Full schema: https://pipedream.com/apps/google-drive/triggers/new-files-instant-polling.md

### `google_drive-new-files-shared-drive` — New Files (Shared Drive) (Polling)

Emit new event when a new file is added in your shared Google Drive

Full schema: https://pipedream.com/apps/google-drive/triggers/new-files-shared-drive.md

### `google_drive-new-or-modified-comments` — New or Modified Comments (Instant) (Polling)

Emit new event when a comment is created or modified in the selected file

Full schema: https://pipedream.com/apps/google-drive/triggers/new-or-modified-comments.md

### `google_drive-new-or-modified-comments-polling` — New or Modified Comments (Polling) (Polling)

Emit new event when a comment is created or modified in the selected file

Full schema: https://pipedream.com/apps/google-drive/triggers/new-or-modified-comments-polling.md

### `google_drive-new-or-modified-files` — New or Modified Files (Instant) (Polling)

Emit new event when a file in the selected Drive is created, modified or trashed.

Full schema: https://pipedream.com/apps/google-drive/triggers/new-or-modified-files.md

### `google_drive-new-or-modified-files-polling` — New or Modified Files (Polling) (Polling)

Emit new event when a file in the selected Drive is created, modified or trashed. See the documentation

Full schema: https://pipedream.com/apps/google-drive/triggers/new-or-modified-files-polling.md

### `google_drive-new-or-modified-folders` — New or Modified Folders (Instant) (Polling)

Emit new event when a folder is created or modified in the selected Drive

Full schema: https://pipedream.com/apps/google-drive/triggers/new-or-modified-folders.md

### `google_drive-new-or-modified-folders-polling` — New or Modified Folders (Polling) (Polling)

Emit new event when a folder is created or modified in the selected Drive

Full schema: https://pipedream.com/apps/google-drive/triggers/new-or-modified-folders-polling.md

### `google_slides-new-presentation` — New Presentation (Instant) (Polling)

Emit new event each time a new presentation is created in a drive.

Full schema: https://pipedream.com/apps/google-drive/triggers/google_slides-new-presentation.md

### `google_drive-new-shared-drive` — New Shared Drive (Polling)

Emits a new event any time a shared drive is created.

Full schema: https://pipedream.com/apps/google-drive/triggers/new-shared-drive.md

### `google_drive-new-spreadsheet` — New Spreadsheet (Instant) (Polling)

Emit new event when a new spreadsheet is created in a drive.

Full schema: https://pipedream.com/apps/google-drive/triggers/new-spreadsheet.md

### `google_drive-new-spreadsheet-polling` — New Spreadsheet (Polling) (Polling)

Emit new event when a new spreadsheet is created in a drive.

Full schema: https://pipedream.com/apps/google-drive/triggers/new-spreadsheet-polling.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt