Google Drive

Get details of a specific shared drive. Args: - driveId: ID of the shared drive Returns shared drive details.

List all pending access proposals (requests) for a file. Args: - fileId: ID of the file - pageSize: Number of proposals to return (default: 100) - pageToken: Token for pagination Returns list of access proposals.

Get information about the current user and Drive settings. Args: - fields: Specific fields to return (optional, returns all by default) Available fields: - user: Current user info (displayName, email, photoLink) - storageQuota: Storage limits and usage - importFormats: Supported import formats - exportFormats: Supported export formats - maxUploadSize: Maximum file upload size - appInstalled: Whether app is installed - folderColorPalette: Available folder colors - driveThemes: Available drive themes - canCreateDrives: Whether user can create shared drives Returns user and Drive information.

Get the current storage quota and usage. Returns storage quota details including: - limit: Total storage limit (in bytes) - usage: Current total usage - usageInDrive: Usage in Drive (excluding trash) - usageInDriveTrash: Usage in trash

Get information about the current authenticated user. Returns user details including: - displayName: User's display name - emailAddress: User's email address - photoLink: Link to user's profile photo - permissionId: User's permission ID

Get available export formats for Google Workspace files. Returns a map of source MIME types to available export formats. Useful for knowing which formats you can use with googledrive_export_file.

Get available import formats for Google Workspace files. Returns a map of source MIME types that can be imported to Google Workspace formats. Useful for knowing which file types can be converted to Google Docs/Sheets/Slides.

Get details of a specific access proposal. Args: - fileId: ID of the file - proposalId: ID of the access proposal Returns access proposal details.

Accept an access proposal, granting the requested access. Args: - fileId: ID of the file - proposalId: ID of the access proposal to accept - role: Role to grant (optional, defaults to requested role) - sendNotification: Send notification to the requester (default: true) Returns confirmation of acceptance.

Deny an access proposal, rejecting the access request. Args: - fileId: ID of the file - proposalId: ID of the access proposal to deny - sendNotification: Send notification to the requester (default: true) Returns confirmation of denial.

List all apps that the user has installed or authorized. Args: - appFilterExtensions: Filter by file extension (e.g., "pdf,doc") - appFilterMimeTypes: Filter by MIME type (e.g., "application/pdf") - languageCode: Language code for app descriptions (e.g., "en") Returns list of installed/authorized apps.

Get details of a specific app. Args: - appId: ID of the app Returns app details.

Get a starting page token for tracking future changes. Use this to get the initial token, then use googledrive_list_changes to track changes from that point. Args: - driveId: ID of shared drive to track (optional) Returns a page token to use with googledrive_list_changes.

List changes since a specific page token. Use googledrive_get_changes_start_token to get the initial token. Args: - pageToken: Page token from previous call or start token - pageSize: Number of changes to return (default: 100) - driveId: ID of shared drive to track (optional) - includeRemoved: Include removed files (default: true) - restrictToMyDrive: Only track My Drive changes Returns list of changes and a new page token for the next call.

Set up a webhook to receive change notifications. Args: - pageToken: Starting page token - channelId: Unique ID for this watch channel (UUID recommended) - webhookUrl: URL to receive notifications - token: Optional token to include in notifications - expirationTime: When the watch expires (RFC 3339, max 24 hours) - driveId: Shared drive to watch (optional) Returns the created channel info.

Set up a webhook to receive notifications when a specific file changes. Args: - fileId: ID of the file to watch - channelId: Unique ID for this watch channel (UUID recommended) - webhookUrl: URL to receive notifications - token: Optional token to include in notifications - expirationTime: When the watch expires (RFC 3339, max 24 hours) Returns the created channel info.

Stop receiving notifications for a watch channel. Args: - channelId: ID of the channel to stop - resourceId: Resource ID from the channel creation response Returns confirmation of channel stopped.

List all shared drives the user has access to. Args: - pageSize: Number of drives to return (default: 100) - pageToken: Token for pagination - query: Search query for filtering drives Returns paginated list of shared drives.

List all comments on a file. Args: - fileId: ID of the file - pageSize: Number of comments to return (default: 100) - pageToken: Token for pagination - includeDeleted: Include deleted comments - startModifiedTime: Filter by modification time (RFC 3339) Returns paginated list of comments.

Get a specific comment by ID. Args: - fileId: ID of the file - commentId: ID of the comment - includeDeleted: Include if deleted Returns comment details.

Add a comment to a file. Args: - fileId: ID of the file - content: Comment text - anchor: JSON anchor for specific location (optional, advanced) Returns the created comment.

Update an existing comment. Args: - fileId: ID of the file - commentId: ID of the comment - content: New comment text Returns the updated comment.

Delete a comment. Args: - fileId: ID of the file - commentId: ID of the comment to delete Returns confirmation of deletion.

List all replies to a comment. Args: - fileId: ID of the file - commentId: ID of the comment - pageSize: Number of replies to return (default: 100) - pageToken: Token for pagination - includeDeleted: Include deleted replies Returns paginated list of replies.

Get a specific reply by ID. Args: - fileId: ID of the file - commentId: ID of the comment - replyId: ID of the reply - includeDeleted: Include if deleted Returns reply details.

Add a reply to a comment. Args: - fileId: ID of the file - commentId: ID of the comment - content: Reply text - action: Optional action (resolve or reopen) Returns the created reply.

Update an existing reply. Args: - fileId: ID of the file - commentId: ID of the comment - replyId: ID of the reply - content: New reply text Returns the updated reply.

Delete a reply. Args: - fileId: ID of the file - commentId: ID of the comment - replyId: ID of the reply to delete Returns confirmation of deletion.

Resolve a comment by adding a reply with resolve action. Args: - fileId: ID of the file - commentId: ID of the comment to resolve - content: Optional resolution message Returns the created reply.

Reopen a resolved comment by adding a reply with reopen action. Args: - fileId: ID of the file - commentId: ID of the comment to reopen - content: Optional reopen message Returns the created reply.

Create a new shared drive. Args: - name: Name of the shared drive - requestId: Unique request ID for idempotency - themeId: Theme ID for the drive background (optional) Note: Requires Google Workspace account with shared drive enabled. Returns the created shared drive.

Update a shared drive's properties. Args: - driveId: ID of the shared drive - name: New name (optional) - colorRgb: Theme color in RGB hex format (optional) - themeId: Theme ID (optional) Returns the updated shared drive.

Permanently delete a shared drive. Args: - driveId: ID of the shared drive to delete Warning: This permanently deletes the shared drive. The drive must be empty. Returns confirmation of deletion.

Hide a shared drive from the default view. Args: - driveId: ID of the shared drive to hide Returns the updated shared drive.

Restore a hidden shared drive to the default view. Args: - driveId: ID of the shared drive to unhide Returns the updated shared drive.

Update sharing restrictions for a shared drive. Args: - driveId: ID of the shared drive - adminManagedRestrictions: Restrict modifications to admins - copyRequiresWriterPermission: Restrict copying to writers only - domainUsersOnly: Restrict to domain users only - driveMembersOnly: Restrict to drive members only - sharingFoldersRequiresOrganizerPermission: Require organizer to share folders Returns the updated shared drive.

List files in Google Drive with optional filtering. Args: - query: Search query (Google Drive query format, e.g., "name contains 'report'" or "mimeType='application/pdf'") - pageSize: Number of files to return (1-1000, default: 100) - pageToken: Token for pagination - orderBy: Sort order (e.g., "modifiedTime desc", "name") - spaces: Comma-separated list of spaces to query (drive, appDataFolder) - includeSharedDrives: Whether to include shared drive items Returns paginated list of files with metadata.

Get metadata for a specific file. Args: - fileId: The ID of the file - fields: Comma-separated list of fields to return (optional) Returns detailed file metadata.

Create a new file in Google Drive. Args: - name: Name of the file - mimeType: MIME type (e.g., "text/plain", "application/json") - parentId: ID of parent folder (optional, defaults to root) - description: File description (optional) - content: File content as text (optional) Returns the created file metadata.

Update a file's metadata or content. Args: - fileId: ID of the file to update - name: New name (optional) - description: New description (optional) - content: New content (optional) - addParents: Parent folder IDs to add (comma-separated) - removeParents: Parent folder IDs to remove (comma-separated) - starred: Whether the file is starred - trashed: Whether to move to trash Returns the updated file metadata.

Create a copy of a file. Args: - fileId: ID of the file to copy - name: Name for the copy (optional) - parentId: Parent folder ID for the copy (optional) - description: Description for the copy (optional) Returns the copied file metadata.

Permanently delete a file (bypasses trash). Args: - fileId: ID of the file to delete Returns confirmation of deletion.

Permanently delete all files in the trash. Returns confirmation of trash emptied.

Export a Google Workspace document to a different format. Args: - fileId: ID of the Google Workspace file - mimeType: Target MIME type (e.g., "application/pdf", "text/plain", "text/html") Common export formats: - Google Docs: application/pdf, text/plain, text/html, application/rtf, application/vnd.oasis.opendocument.text, application/vnd.openxmlformats-officedocument.wordprocessingml.document - Google Sheets: application/pdf, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet - Google Slides: application/pdf, application/vnd.openxmlformats-officedocument.presentationml.presentation Returns the exported content.

Download a file's content. Args: - fileId: ID of the file to download Note: For Google Workspace files (Docs, Sheets, Slides), use googledrive_export_file instead. Returns the file content.

Generate file IDs for use with create requests. Args: - count: Number of IDs to generate (1-1000, default: 10) - space: Space for the IDs (drive or appDataFolder) Returns array of generated IDs.

Search for files with advanced query options. Common query examples: - name contains 'report': Files with "report" in the name - mimeType = 'application/pdf': PDF files only - 'folderId' in parents: Files in a specific folder - trashed = true: Files in trash - starred = true: Starred files - sharedWithMe = true: Files shared with you - modifiedTime > '2024-01-01': Modified after date - fullText contains 'keyword': Full text search Combine with 'and', 'or', 'not'. Args: - query: Search query - pageSize: Results per page (default: 100) - pageToken: Pagination token Returns matching files.

Create a new folder in Google Drive. Args: - name: Name of the folder - parentId: ID of parent folder (optional, defaults to root) Returns the created folder metadata.

List the contents of a folder. Args: - folderId: ID of the folder (use 'root' for root folder) - pageSize: Number of items to return (1-1000, default: 100) - pageToken: Token for pagination - orderBy: Sort order (e.g., "name", "modifiedTime desc") Returns paginated list of files and folders.

Move a file to a different folder. Args: - fileId: ID of the file to move - newParentId: ID of the destination folder - removeFromCurrentParent: Whether to remove from current parent (default: true) Returns the updated file metadata.

List all permissions (sharing settings) for a file or folder. Args: - fileId: ID of the file or folder - pageSize: Number of permissions to return (default: 100) - pageToken: Token for pagination Returns list of permissions with details.

Get details of a specific permission. Args: - fileId: ID of the file or folder - permissionId: ID of the permission Returns permission details.

Share a file or folder with a specific user. Args: - fileId: ID of the file or folder - email: Email address of the user - role: Permission role (reader, commenter, writer, owner) - sendNotification: Whether to send notification email (default: true) - emailMessage: Custom message for notification email - transferOwnership: Transfer ownership (required when role is owner) Roles: - reader: Can view - commenter: Can view and comment - writer: Can view, comment, and edit - owner: Full ownership (use with transferOwnership) Returns the created permission.

Share a file or folder with a Google Group. Args: - fileId: ID of the file or folder - email: Email address of the Google Group - role: Permission role (reader, commenter, writer, organizer, fileOrganizer) - sendNotification: Whether to send notification email Returns the created permission.

Share a file or folder with an entire domain. Args: - fileId: ID of the file or folder - domain: Domain name (e.g., "example.com") - role: Permission role (reader, commenter, writer) - allowFileDiscovery: Whether file can be discovered via search Returns the created permission.

Make a file or folder publicly accessible to anyone. Args: - fileId: ID of the file or folder - role: Permission role (reader, commenter, writer) - allowFileDiscovery: Whether file can be found via search engines Warning: This makes the file accessible to anyone with the link. Returns the created permission.

Update an existing permission (change role or expiration). Args: - fileId: ID of the file or folder - permissionId: ID of the permission to update - role: New role - expirationTime: Expiration date (RFC 3339 format, e.g., "2024-12-31T23:59:59Z") Returns the updated permission.

Remove a permission (revoke sharing). Args: - fileId: ID of the file or folder - permissionId: ID of the permission to remove Returns confirmation of removal.

List all revisions (version history) of a file. Args: - fileId: ID of the file - pageSize: Number of revisions to return (default: 100) - pageToken: Token for pagination Returns paginated list of revisions.

Get details of a specific revision. Args: - fileId: ID of the file - revisionId: ID of the revision Returns revision details.

Update revision properties (e.g., keep forever). Args: - fileId: ID of the file - revisionId: ID of the revision - keepForever: Whether to keep this revision permanently - published: Whether this revision is published - publishAuto: Whether to auto-publish future revisions - publishedOutsideDomain: Whether published outside domain Returns the updated revision.

Delete a revision (cannot delete the current/head revision). Args: - fileId: ID of the file - revisionId: ID of the revision to delete Note: Cannot delete the most recent revision. Returns confirmation of deletion.

Mark a revision to be kept forever (won't be auto-deleted). Args: - fileId: ID of the file - revisionId: ID of the revision Returns the updated revision.