All data sources

Google Drive

OAuthdrive

Google Drive connector for listing, searching, downloading, and uploading files. CRITICAL USAGE RULES: 1. Use listFiles() first to discover folder and file IDs. 2. downloadFile() returns file content as base64 (decode client-side if needed). Google Workspace files are auto-exported. 3. searchFiles() searches by name across the entire drive. 4. uploadFile() requires filename + exactly one of contentBase64, contentText, sourceUrl, or fileContent (Buffer/Uint8Array). Prefer sourceUrl (server fetches the bytes) over contentBase64 for large files. 5. listFiles() supports pageSize, pageToken, orderBy, and q (query) for advanced filtering. 6. getFileById(), getFileByPath(), createFolder(), deleteFile(), moveFile(), copyFile(), and createShareLink() are available for file management.

Provenance

PublisherGoogle Drive

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationCredentials required (OAuth)

Methods (11)

  • listFiles

    read

    List Google Drive files in the root or a specific folder.

    Input schema
    {
      "type": "object",
      "properties": {
        "folderId": {
          "type": "string",
          "description": "Optional parent folder ID."
        },
        "pageSize": {
          "type": "number",
          "description": "Maximum files to return."
        },
        "pageToken": {
          "type": "string",
          "description": "Pagination token."
        },
        "orderBy": {
          "type": "string",
          "description": "Drive ordering expression."
        },
        "q": {
          "type": "string",
          "description": "Optional advanced Drive query."
        }
      },
      "additionalProperties": true
    }
  • searchFiles

    read

    Search Google Drive by text query.

    Required paramsquery
    Input schema
    {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "Search text."
        },
        "pageSize": {
          "type": "number",
          "description": "Maximum files to return."
        },
        "pageToken": {
          "type": "string",
          "description": "Pagination token."
        }
      },
      "required": [
        "query"
      ],
      "additionalProperties": true
    }
  • downloadFile

    read

    Download a Google Drive file by ID, auto-exporting Google Workspace formats.

    Required paramsfileId
    Input schema
    {
      "type": "object",
      "properties": {
        "fileId": {
          "type": "string",
          "description": "Google Drive file ID."
        }
      },
      "required": [
        "fileId"
      ],
      "additionalProperties": true
    }
  • uploadFile

    write

    Upload a file to Google Drive. Provide exactly one of contentBase64, contentText, or sourceUrl.

    Required paramsfilename
    Input schema
    {
      "type": "object",
      "properties": {
        "filename": {
          "type": "string",
          "description": "Filename to create."
        },
        "folderId": {
          "type": "string",
          "description": "Optional parent folder ID."
        },
        "folderPath": {
          "type": "string",
          "description": "Optional parent folder path."
        },
        "contentText": {
          "type": "string",
          "description": "UTF-8 text content to upload."
        },
        "contentBase64": {
          "type": "string",
          "description": "Base64-encoded file content."
        },
        "sourceUrl": {
          "type": "string",
          "description": "Public/HTTPS URL the server fetches server-side (use INSTEAD of contentBase64 to avoid inlining large files)."
        },
        "mimeType": {
          "type": "string",
          "description": "MIME type for the upload."
        }
      },
      "required": [
        "filename"
      ],
      "additionalProperties": true
    }
  • createFolder

    write

    Create a folder in Google Drive.

    Required paramsname
    Input schema
    {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Folder name."
        },
        "parentId": {
          "type": "string",
          "description": "Optional parent folder ID. Defaults to \"root\"."
        },
        "folderPath": {
          "type": "string",
          "description": "Optional path-based parent (creates intermediate folders if missing)."
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": true
    }
  • moveFile

    write

    Move a file to a different parent folder. The destination is named parentId — pass the folder ID returned by createFolder/listFiles.

    Required paramsfileIdparentId
    Input schema
    {
      "type": "object",
      "properties": {
        "fileId": {
          "type": "string",
          "description": "Google Drive file ID to move."
        },
        "parentId": {
          "type": "string",
          "description": "Destination folder ID. NOTE: this field is named parentId, not destinationFolderId."
        }
      },
      "required": [
        "fileId",
        "parentId"
      ],
      "additionalProperties": true
    }
  • copyFile

    write

    Make a copy of a Drive file.

    Required paramsfileId
    Input schema
    {
      "type": "object",
      "properties": {
        "fileId": {
          "type": "string",
          "description": "Source file ID."
        },
        "name": {
          "type": "string",
          "description": "Optional new filename for the copy."
        },
        "parentId": {
          "type": "string",
          "description": "Optional destination folder ID for the copy."
        }
      },
      "required": [
        "fileId"
      ],
      "additionalProperties": true
    }
  • deleteFile

    write

    Delete a Drive file (moves to Trash by default).

    Required paramsfileId
    Input schema
    {
      "type": "object",
      "properties": {
        "fileId": {
          "type": "string",
          "description": "Google Drive file ID to delete."
        }
      },
      "required": [
        "fileId"
      ],
      "additionalProperties": true
    }
  • getFileById

    read

    Fetch a Drive file metadata block by ID.

    Required paramsfileId
    Input schema
    {
      "type": "object",
      "properties": {
        "fileId": {
          "type": "string",
          "description": "Google Drive file ID."
        }
      },
      "required": [
        "fileId"
      ],
      "additionalProperties": true
    }
  • getFileByPath

    read

    Look up a Drive file by path-like name (e.g. "/Reports/2024/summary.pdf").

    Required paramspath
    Input schema
    {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Slash-separated path from My Drive root."
        }
      },
      "required": [
        "path"
      ],
      "additionalProperties": true
    }