Google Drive

Google Drive MCP Server for Cloudflare Workers

Available Tools

63 tools available in the Google Drive MCP server. Each tool can be called by AI assistants to perform specific actions.

googledrive_get_drive

Get details of a specific shared drive.

Args:

driveId: ID of the shared drive

Returns shared drive details.

{
  "type": "object",
  "required": [
    "driveId"
  ],
  "properties": {
    "driveId": {
      "type": "string",
      "description": "Shared drive ID"
    }
  }
}

googledrive_list_access_proposals

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    }
  }
}

googledrive_get_about

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.

{
  "type": "object",
  "properties": {
    "fields": {
      "type": "string",
      "description": "Fields to return (comma-separated)"
    }
  }
}

googledrive_get_storage_quota

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

{
  "type": "object",
  "properties": {}
}

googledrive_get_user_info

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

{
  "type": "object",
  "properties": {}
}

googledrive_get_export_formats

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.

{
  "type": "object",
  "properties": {}
}

googledrive_get_import_formats

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.

{
  "type": "object",
  "properties": {}
}

googledrive_get_access_proposal

Get details of a specific access proposal.

Args:

fileId: ID of the file
proposalId: ID of the access proposal

Returns access proposal details.

{
  "type": "object",
  "required": [
    "fileId",
    "proposalId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "proposalId": {
      "type": "string",
      "description": "Access proposal ID"
    }
  }
}

googledrive_accept_access_proposal

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "proposalId": {
      "type": "string",
      "description": "Access proposal ID"
    },
    "sendNotification": {
      "type": "boolean",
      "default": true,
      "description": "Send notification"
    }
  }
}

googledrive_deny_access_proposal

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.

{
  "type": "object",
  "required": [
    "fileId",
    "proposalId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "proposalId": {
      "type": "string",
      "description": "Access proposal ID"
    },
    "sendNotification": {
      "type": "boolean",
      "default": true,
      "description": "Send notification"
    }
  }
}

googledrive_list_apps

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.

{
  "type": "object",
  "properties": {
    "languageCode": {
      "type": "string",
      "description": "Language code"
    },
    "appFilterMimeTypes": {
      "type": "string",
      "description": "Filter by MIME types"
    },
    "appFilterExtensions": {
      "type": "string",
      "description": "Filter by extensions"
    }
  }
}

googledrive_get_app

Get details of a specific app.

Args:

appId: ID of the app

Returns app details.

{
  "type": "object",
  "required": [
    "appId"
  ],
  "properties": {
    "appId": {
      "type": "string",
      "description": "App ID"
    }
  }
}

googledrive_get_changes_start_token

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.

{
  "type": "object",
  "properties": {
    "driveId": {
      "type": "string",
      "description": "Shared drive ID (optional)"
    }
  }
}

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.

{
  "type": "object",
  "required": [
    "pageToken"
  ],
  "properties": {
    "driveId": {
      "type": "string",
      "description": "Shared drive ID"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "description": "Results per page"
    },
    "pageToken": {
      "type": "string",
      "description": "Page token"
    },
    "includeRemoved": {
      "type": "boolean",
      "default": true,
      "description": "Include removed files"
    },
    "restrictToMyDrive": {
      "type": "boolean",
      "default": false,
      "description": "Only My Drive changes"
    }
  }
}

googledrive_watch_changes

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.

{
  "type": "object",
  "required": [
    "pageToken",
    "channelId",
    "webhookUrl"
  ],
  "properties": {
    "token": {
      "type": "string",
      "description": "Optional verification token"
    },
    "driveId": {
      "type": "string",
      "description": "Shared drive ID"
    },
    "channelId": {
      "type": "string",
      "description": "Unique channel ID"
    },
    "pageToken": {
      "type": "string",
      "description": "Starting page token"
    },
    "webhookUrl": {
      "type": "string",
      "description": "Webhook URL"
    },
    "expirationTime": {
      "type": "string",
      "description": "Expiration time (RFC 3339)"
    }
  }
}

googledrive_watch_file

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.

{
  "type": "object",
  "required": [
    "fileId",
    "channelId",
    "webhookUrl"
  ],
  "properties": {
    "token": {
      "type": "string",
      "description": "Optional verification token"
    },
    "fileId": {
      "type": "string",
      "description": "File ID to watch"
    },
    "channelId": {
      "type": "string",
      "description": "Unique channel ID"
    },
    "webhookUrl": {
      "type": "string",
      "description": "Webhook URL"
    },
    "expirationTime": {
      "type": "string",
      "description": "Expiration time (RFC 3339)"
    }
  }
}

googledrive_stop_channel

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.

{
  "type": "object",
  "required": [
    "channelId",
    "resourceId"
  ],
  "properties": {
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "resourceId": {
      "type": "string",
      "description": "Resource ID"
    }
  }
}

googledrive_list_drives

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    }
  }
}

googledrive_list_comments

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "includeDeleted": {
      "type": "boolean",
      "default": false,
      "description": "Include deleted comments"
    },
    "startModifiedTime": {
      "type": "string",
      "description": "Filter by modification time"
    }
  }
}

googledrive_get_comment

Get a specific comment by ID.

Args:

fileId: ID of the file
commentId: ID of the comment
includeDeleted: Include if deleted

Returns comment details.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    },
    "includeDeleted": {
      "type": "boolean",
      "default": false,
      "description": "Include if deleted"
    }
  }
}

googledrive_create_comment

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.

{
  "type": "object",
  "required": [
    "fileId",
    "content"
  ],
  "properties": {
    "anchor": {
      "type": "string",
      "description": "Location anchor (JSON)"
    },
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "content": {
      "type": "string",
      "description": "Comment text"
    }
  }
}

googledrive_update_comment

Update an existing comment.

Args:

fileId: ID of the file
commentId: ID of the comment
content: New comment text

Returns the updated comment.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId",
    "content"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "content": {
      "type": "string",
      "description": "New comment text"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    }
  }
}

googledrive_delete_comment

Delete a comment.

Args:

fileId: ID of the file
commentId: ID of the comment to delete

Returns confirmation of deletion.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    }
  }
}

googledrive_list_replies

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.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "includeDeleted": {
      "type": "boolean",
      "default": false,
      "description": "Include deleted replies"
    }
  }
}

googledrive_get_reply

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.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId",
    "replyId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "replyId": {
      "type": "string",
      "description": "Reply ID"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    },
    "includeDeleted": {
      "type": "boolean",
      "default": false,
      "description": "Include if deleted"
    }
  }
}

googledrive_create_reply

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.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId",
    "content"
  ],
  "properties": {
    "action": {
      "enum": [
        "resolve",
        "reopen"
      ],
      "type": "string",
      "description": "Action to perform"
    },
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "content": {
      "type": "string",
      "description": "Reply text"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    }
  }
}

googledrive_update_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.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId",
    "replyId",
    "content"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "content": {
      "type": "string",
      "description": "New reply text"
    },
    "replyId": {
      "type": "string",
      "description": "Reply ID"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    }
  }
}

googledrive_delete_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.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId",
    "replyId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "replyId": {
      "type": "string",
      "description": "Reply ID"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    }
  }
}

googledrive_resolve_comment

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.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "content": {
      "type": "string",
      "default": "Resolved",
      "description": "Resolution message"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    }
  }
}

googledrive_reopen_comment

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.

{
  "type": "object",
  "required": [
    "fileId",
    "commentId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "content": {
      "type": "string",
      "default": "Reopened",
      "description": "Reopen message"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    }
  }
}

googledrive_create_drive

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.

{
  "type": "object",
  "required": [
    "name",
    "requestId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Shared drive name"
    },
    "themeId": {
      "type": "string",
      "description": "Theme ID"
    },
    "requestId": {
      "type": "string",
      "description": "Unique request ID"
    }
  }
}

googledrive_update_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.

{
  "type": "object",
  "required": [
    "driveId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "driveId": {
      "type": "string",
      "description": "Shared drive ID"
    },
    "themeId": {
      "type": "string",
      "description": "Theme ID"
    },
    "colorRgb": {
      "type": "string",
      "description": "Theme color (hex)"
    }
  }
}

googledrive_delete_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.

{
  "type": "object",
  "required": [
    "driveId"
  ],
  "properties": {
    "driveId": {
      "type": "string",
      "description": "Shared drive ID"
    }
  }
}

googledrive_hide_drive

Hide a shared drive from the default view.

Args:

driveId: ID of the shared drive to hide

Returns the updated shared drive.

{
  "type": "object",
  "required": [
    "driveId"
  ],
  "properties": {
    "driveId": {
      "type": "string",
      "description": "Shared drive ID"
    }
  }
}

googledrive_unhide_drive

Restore a hidden shared drive to the default view.

Args:

driveId: ID of the shared drive to unhide

Returns the updated shared drive.

{
  "type": "object",
  "required": [
    "driveId"
  ],
  "properties": {
    "driveId": {
      "type": "string",
      "description": "Shared drive ID"
    }
  }
}

googledrive_update_drive_restrictions

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.

{
  "type": "object",
  "required": [
    "driveId"
  ],
  "properties": {
    "driveId": {
      "type": "string",
      "description": "Shared drive ID"
    },
    "domainUsersOnly": {
      "type": "boolean",
      "description": "Domain users only"
    },
    "driveMembersOnly": {
      "type": "boolean",
      "description": "Drive members only"
    },
    "adminManagedRestrictions": {
      "type": "boolean",
      "description": "Admin-managed restrictions"
    },
    "copyRequiresWriterPermission": {
      "type": "boolean",
      "description": "Copy requires writer"
    }
  }
}

googledrive_list_files

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query in Google Drive query format"
    },
    "spaces": {
      "type": "string",
      "description": "Spaces to query (drive, appDataFolder)"
    },
    "orderBy": {
      "type": "string",
      "description": "Sort order (e.g., \"modifiedTime desc"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of files"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "includeSharedDrives": {
      "type": "boolean",
      "default": true,
      "description": "Include shared drive items"
    }
  }
}

googledrive_get_file

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "Fields to return"
    },
    "fileId": {
      "type": "string",
      "description": "File ID"
    }
  }
}

googledrive_create_file

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.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "File name"
    },
    "content": {
      "type": "string",
      "description": "File content (text)"
    },
    "mimeType": {
      "type": "string",
      "description": "MIME type"
    },
    "parentId": {
      "type": "string",
      "description": "Parent folder ID"
    },
    "description": {
      "type": "string",
      "description": "File description"
    }
  }
}

googledrive_update_file

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "content": {
      "type": "string",
      "description": "New content"
    },
    "starred": {
      "type": "boolean",
      "description": "Starred status"
    },
    "trashed": {
      "type": "boolean",
      "description": "Move to trash"
    },
    "addParents": {
      "type": "string",
      "description": "Parent IDs to add"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "removeParents": {
      "type": "string",
      "description": "Parent IDs to remove"
    }
  }
}

googledrive_copy_file

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Name for the copy"
    },
    "fileId": {
      "type": "string",
      "description": "File ID to copy"
    },
    "parentId": {
      "type": "string",
      "description": "Parent folder ID"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

googledrive_delete_file

Permanently delete a file (bypasses trash).

Args:

fileId: ID of the file to delete

Returns confirmation of deletion.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID to delete"
    }
  }
}

googledrive_empty_trash

Permanently delete all files in the trash.

Returns confirmation of trash emptied.

{
  "type": "object",
  "properties": {}
}

googledrive_export_file

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.

{
  "type": "object",
  "required": [
    "fileId",
    "mimeType"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID to export"
    },
    "mimeType": {
      "type": "string",
      "description": "Target MIME type"
    }
  }
}

googledrive_download_file

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID to download"
    }
  }
}

googledrive_generate_ids

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.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of IDs"
    },
    "space": {
      "enum": [
        "drive",
        "appDataFolder"
      ],
      "type": "string",
      "default": "drive",
      "description": "Space"
    }
  }
}

googledrive_search_files

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.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "description": "Results per page"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    }
  }
}

googledrive_create_folder

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.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Folder name"
    },
    "parentId": {
      "type": "string",
      "description": "Parent folder ID"
    }
  }
}

googledrive_list_folder

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.

{
  "type": "object",
  "required": [
    "folderId"
  ],
  "properties": {
    "orderBy": {
      "type": "string",
      "description": "Sort order"
    },
    "folderId": {
      "type": "string",
      "description": "Folder ID (use \"root\" for root folder)"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of items"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    }
  }
}

googledrive_move_file

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.

{
  "type": "object",
  "required": [
    "fileId",
    "newParentId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID to move"
    },
    "newParentId": {
      "type": "string",
      "description": "Destination folder ID"
    },
    "removeFromCurrentParent": {
      "type": "boolean",
      "default": true,
      "description": "Remove from current parent"
    }
  }
}

googledrive_list_permissions

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File or folder ID"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    }
  }
}

googledrive_get_permission

Get details of a specific permission.

Args:

fileId: ID of the file or folder
permissionId: ID of the permission

Returns permission details.

{
  "type": "object",
  "required": [
    "fileId",
    "permissionId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File or folder ID"
    },
    "permissionId": {
      "type": "string",
      "description": "Permission ID"
    }
  }
}

googledrive_share_with_user

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.

{
  "type": "object",
  "required": [
    "fileId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "User email address"
    },
    "fileId": {
      "type": "string",
      "description": "File or folder ID"
    },
    "emailMessage": {
      "type": "string",
      "description": "Custom email message"
    },
    "sendNotification": {
      "type": "boolean",
      "default": true,
      "description": "Send notification"
    },
    "transferOwnership": {
      "type": "boolean",
      "description": "Transfer ownership"
    }
  }
}

googledrive_share_with_group

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.

{
  "type": "object",
  "required": [
    "fileId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Group email address"
    },
    "fileId": {
      "type": "string",
      "description": "File or folder ID"
    },
    "sendNotification": {
      "type": "boolean",
      "default": true,
      "description": "Send notification"
    }
  }
}

googledrive_share_with_domain

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.

{
  "type": "object",
  "required": [
    "fileId",
    "domain",
    "role"
  ],
  "properties": {
    "role": {
      "enum": [
        "reader",
        "commenter",
        "writer"
      ],
      "type": "string",
      "description": "Permission role"
    },
    "domain": {
      "type": "string",
      "description": "Domain name"
    },
    "fileId": {
      "type": "string",
      "description": "File or folder ID"
    },
    "allowFileDiscovery": {
      "type": "boolean",
      "default": false,
      "description": "Allow file discovery"
    }
  }
}

googledrive_make_public

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "role": {
      "enum": [
        "reader",
        "commenter",
        "writer"
      ],
      "type": "string",
      "default": "reader",
      "description": "Permission role"
    },
    "fileId": {
      "type": "string",
      "description": "File or folder ID"
    },
    "allowFileDiscovery": {
      "type": "boolean",
      "default": false,
      "description": "Allow search engine indexing"
    }
  }
}

googledrive_update_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.

{
  "type": "object",
  "required": [
    "fileId",
    "permissionId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File or folder ID"
    },
    "permissionId": {
      "type": "string",
      "description": "Permission ID"
    },
    "expirationTime": {
      "type": "string",
      "description": "Expiration date (RFC 3339)"
    }
  }
}

googledrive_remove_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.

{
  "type": "object",
  "required": [
    "fileId",
    "permissionId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File or folder ID"
    },
    "permissionId": {
      "type": "string",
      "description": "Permission ID"
    }
  }
}

googledrive_list_revisions

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.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "pageSize": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "description": "Results per page"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    }
  }
}

googledrive_get_revision

Get details of a specific revision.

Args:

fileId: ID of the file
revisionId: ID of the revision

Returns revision details.

{
  "type": "object",
  "required": [
    "fileId",
    "revisionId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "revisionId": {
      "type": "string",
      "description": "Revision ID"
    }
  }
}

googledrive_update_revision

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.

{
  "type": "object",
  "required": [
    "fileId",
    "revisionId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "published": {
      "type": "boolean",
      "description": "Publish this revision"
    },
    "revisionId": {
      "type": "string",
      "description": "Revision ID"
    },
    "keepForever": {
      "type": "boolean",
      "description": "Keep this revision permanently"
    },
    "publishAuto": {
      "type": "boolean",
      "description": "Auto-publish future revisions"
    },
    "publishedOutsideDomain": {
      "type": "boolean",
      "description": "Publish outside domain"
    }
  }
}

googledrive_delete_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.

{
  "type": "object",
  "required": [
    "fileId",
    "revisionId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "revisionId": {
      "type": "string",
      "description": "Revision ID"
    }
  }
}

googledrive_keep_revision

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.

{
  "type": "object",
  "required": [
    "fileId",
    "revisionId"
  ],
  "properties": {
    "fileId": {
      "type": "string",
      "description": "File ID"
    },
    "revisionId": {
      "type": "string",
      "description": "Revision ID"
    }
  }
}