Google Drive
io.github.mcp-z/mcp-drive
20 toolsauthSTDIO, HTTPregistry active
Summary
Connects Claude directly to the Google Drive API with search, navigation, and file management operations. You get tools for querying files by name or metadata, browsing folder hierarchies, creating new folders, moving items, and trashing content. Supports three auth modes: OAuth loopback for local use, service accounts for headless deployments, and DCR for self-hosted setups. The search tool uses Drive's native query syntax, and there's a folder-path resource for resolving full directory trees. Runs over stdio for desktop clients or HTTP for remote access. Reach for this when you need Claude to interact with Drive content beyond simple uploads, especially for organizing files, building folder structures, or surfacing documents based on search criteria.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
20 tools
GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCEModifies sharing permissions for an existing google drive file, granting a specified role to a user, group, domain, or 'anyone'.5 params
Modifies sharing permissions for an existing google drive file, granting a specified role to a user, group, domain, or 'anyone'.
Parameters* required
rolestringPermission role to grant.
typestringType of grantee for the permission.
domainstringDomain to grant permission to (e.g., 'example.com'). Required if 'type' is 'domain'.
file_idstringUnique identifier of the file to update sharing settings for.
email_addressstringEmail address of the user or group. Required if 'type' is 'user' or 'group'.
GOOGLEDRIVE_COPY_FILEDuplicates an existing file in google drive, identified by its `file id`.2 params
Duplicates an existing file in google drive, identified by its `file id`.
Parameters* required
file_idstringThe unique identifier for the file on Google Drive that you want to copy. This ID can be retrieved from the file's shareable link or via other Google Drive API calls.
new_titlestringThe title to assign to the new copy of the file. If not provided, the copied file will have the same title as the original, prefixed with 'Copy of '.
GOOGLEDRIVE_CREATE_COMMENTTool to create a comment on a file. use when you need to add a new comment to a specific file in google drive.5 params
Tool to create a comment on a file. use when you need to add a new comment to a specific file in google drive.
Parameters* required
anchorstringA JSON string representing the region of the document to which the comment is anchored (e.g., {'type': 'line', 'line': 12}).
contentstringThe plain text content of the comment.
file_idstringThe ID of the file.
quoted_file_content_valuestringThe quoted content itself.
quoted_file_content_mime_typestringThe MIME type of the quoted content.
GOOGLEDRIVE_CREATE_DRIVETool to create a new shared drive. use when you need to programmatically create a new shared drive for collaboration or storage.6 params
Tool to create a new shared drive. use when you need to programmatically create a new shared drive for collaboration or storage.
Parameters* required
namestringThe name of this shared drive.
hiddenbooleanWhether the shared drive is hidden from default view.default: false
themeIdstringThe ID of the theme from which the background image and color will be set. The set of possible driveThemes can be retrieved from a drive.about.get response. When not specified on a drive.drives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile.
colorRgbstringThe color of this shared drive as an RGB hex string. It can only be set on a drive.drives.update request that does not set themeId.
requestIdstringAn ID, such as a random UUID, which uniquely identifies this user's request for idempotent creation of a shared drive. A repeated request by the same user and with the same request ID will avoid creating duplicates by attempting to create the same shared drive. If the shared drive already exists a 409 error will be returned.
backgroundImageFileobjectAn image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on drive.drives.update requests that don't set themeId. When specified, all fields of the backgroundImageFile must be set.
GOOGLEDRIVE_CREATE_FILECreates a new file or folder with metadata. use to create empty files or folders, or files with content by providing it in the request body (though this action primarily focuses on metadata creation).6 params
Creates a new file or folder with metadata. use to create empty files or folders, or files with content by providing it in the request body (though this action primarily focuses on metadata creation).
Parameters* required
namestringThe name of the file.
fieldsstringA comma-separated list of fields to include in the response.
parentsarrayThe IDs of parent folders.
starredbooleanWhether the user has starred the file.
mimeTypestringThe MIME type of the file.
descriptionstringA short description of the file.
GOOGLEDRIVE_CREATE_FILE_FROM_TEXTCreates a new file in google drive from provided text content (up to 10mb), supporting various formats including automatic conversion to google workspace types.4 params
Creates a new file in google drive from provided text content (up to 10mb), supporting various formats including automatic conversion to google workspace types.
Parameters* required
file_namestringDesired name for the new file on Google Drive.
mime_typestringMIME type for the new file, determining how Google Drive interprets its content.default: text/plain
parent_idstringID of the parent folder in Google Drive; if omitted, the file is created in the root of 'My Drive'.
text_contentstringPlain text content to be written into the new file.
GOOGLEDRIVE_CREATE_FOLDERCreates a new folder in google drive, optionally within a parent folder specified by its id or name; if a parent name is provided but not found, the action will fail.2 params
Creates a new folder in google drive, optionally within a parent folder specified by its id or name; if a parent name is provided but not found, the action will fail.
Parameters* required
parent_idstringID or name of the parent folder. If a name is provided, the action attempts to find it. If an ID is provided, it must be a valid Google Drive folder ID. If omitted, the folder is created in the Drive root.
folder_namestringName for the new folder.
GOOGLEDRIVE_CREATE_REPLYTool to create a reply to a comment in google drive. use when you need to respond to an existing comment on a file.5 params
Tool to create a reply to a comment in google drive. use when you need to respond to an existing comment on a file.
Parameters* required
actionstringThe action the reply performed to the parent comment. Valid values are: resolve, reopen.
fieldsstringSelector specifying which fields to include in a partial response.
contentstringThe plain text content of the reply. HTML content is not supported.
file_idstringThe ID of the file.
comment_idstringThe ID of the comment.
GOOGLEDRIVE_CREATE_SHORTCUT_TO_FILETool to create a shortcut to a file or folder in google drive. use when you need to link to an existing drive item from another location without duplicating it.8 params
Tool to create a shortcut to a file or folder in google drive. use when you need to link to an existing drive item from another location without duplicating it.
Parameters* required
namestringThe name of the shortcut.
target_idstringThe ID of the file or folder that this shortcut points to.
includeLabelsstringA comma-separated list of IDs of labels to include in the labelInfo part of the response.
target_mime_typestringThe MIME type of the target file or folder. While optional, providing it can be helpful.
supportsAllDrivesbooleanWhether the requesting application supports both My Drives and shared drives. Recommended to set to true if interacting with shared drives.
keepRevisionForeverbooleanWhether to set the 'keepForever' field in the new head revision.
ignoreDefaultVisibilitybooleanWhether to ignore the domain's default visibility settings for the created file.
includePermissionsForViewstringSpecifies which additional view's permissions to include in the response. Only 'published' is supported.
GOOGLEDRIVE_DELETE_COMMENTDeletes a comment from a file. use when you need to remove a specific comment from a google drive file.2 params
Deletes a comment from a file. use when you need to remove a specific comment from a google drive file.
Parameters* required
file_idstringThe ID of the file.
comment_idstringThe ID of the comment.
GOOGLEDRIVE_DELETE_DRIVETool to permanently delete a shared drive. use when you need to remove a shared drive and its contents (if specified).3 params
Tool to permanently delete a shared drive. use when you need to remove a shared drive and its contents (if specified).
Parameters* required
driveIdstringThe ID of the shared drive.
allowItemDeletionbooleanWhether any items inside the shared drive should also be deleted. This option is only supported when `useDomainAdminAccess` is also set to `true`.
useDomainAdminAccessbooleanIssue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.
GOOGLEDRIVE_DELETE_PERMISSIONDeletes a permission from a file by permission id. use when you need to revoke access for a specific user or group from a file.4 params
Deletes a permission from a file by permission id. use when you need to revoke access for a specific user or group from a file.
Parameters* required
file_idstringThe ID of the file or shared drive.
permission_idstringThe ID of the permission.
supportsAllDrivesbooleanWhether the requesting application supports both My Drives and shared drives.
useDomainAdminAccessbooleanIssue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
GOOGLEDRIVE_DELETE_REPLYTool to delete a specific reply by reply id. use when you need to remove a reply from a comment on a file.3 params
Tool to delete a specific reply by reply id. use when you need to remove a reply from a comment on a file.
Parameters* required
file_idstringThe ID of the file.
reply_idstringThe ID of the reply.
comment_idstringThe ID of the comment.
GOOGLEDRIVE_DOWNLOAD_FILEDownloads a file from google drive by its id. for google workspace documents (docs, sheets, slides), optionally exports to a specified `mime type`. for other file types, downloads in their native format regardless of mime type.2 params
Downloads a file from google drive by its id. for google workspace documents (docs, sheets, slides), optionally exports to a specified `mime type`. for other file types, downloads in their native format regardless of mime type.
Parameters* required
file_idstringThe unique identifier of the file to be downloaded from Google Drive. This ID can typically be found in the file's URL in Google Drive or obtained from API calls that list files.
mime_typestringTarget MIME type for exporting Google Workspace documents (e.g., Google Doc, Sheet, Slide). Supported export formats vary by file type; e.g., text/plain is only supported for Google Docs, not Sheets or Slides. This parameter is automatically ignored for non-Google Workspace files, which are downloaded in their native format. Only specify this when you want to export a Google Workspace document to a different format (e.g., export Google Doc to PDF).one of
application/vnd.openxmlformats-officedocument.wordprocessingml.document · application/vnd.oasis.opendocument.text · application/rtf · application/pdf · text/plain · application/zipGOOGLEDRIVE_EDIT_FILEUpdates an existing google drive file by overwriting its entire content with new text (max 10mb).3 params
Updates an existing google drive file by overwriting its entire content with new text (max 10mb).
Parameters* required
contentstringNew textual content to overwrite the existing file; will be UTF-8 encoded for upload.
file_idstringIdentifier of the Google Drive file to update.
mime_typestringMIME type of the 'content' being uploaded; must accurately represent its format.default: text/plain
GOOGLEDRIVE_EMPTY_TRASHTool to permanently delete all of the user's trashed files. use when you want to empty the trash in google drive.2 params
Tool to permanently delete all of the user's trashed files. use when you want to empty the trash in google drive.
Parameters* required
driveIdstringIf set, empties the trash of the provided shared drive. This parameter is ignored if the item is not in a shared drive.
enforceSingleParentbooleanDeprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root. This parameter is ignored if the item is not in a shared drive.
GOOGLEDRIVE_FILES_MODIFY_LABELSModifies the set of labels applied to a file. returns a list of the labels that were added or modified. use when you need to programmatically change labels on a google drive file, such as adding, updating, or removing them.3 params
Modifies the set of labels applied to a file. returns a list of the labels that were added or modified. use when you need to programmatically change labels on a google drive file, such as adding, updating, or removing them.
Parameters* required
kindstringThis is always drive#modifyLabelsRequest.default: drive#modifyLabelsRequest
file_idstringThe ID of the file.
label_modificationsarrayThe list of modifications to apply to the labels on the file.
GOOGLEDRIVE_FIND_FILETool to list or search for files and folders in google drive. use when you need to find specific files based on query criteria or list contents of a drive/folder.10 params
Tool to list or search for files and folders in google drive. use when you need to find specific files based on query criteria or list contents of a drive/folder.
Parameters* required
qstringA query for filtering the file results. See Google Drive API documentation for query syntax. Example: \"name contains 'report' and mimeType = 'application/pdf'\"
fieldsstringSelector specifying which fields to include in a partial response. Use '*' for all fields or a comma-separated list, e.g., 'nextPageToken,files(id,name,mimeType)'.default: *
spacesstringA comma-separated list of spaces to query. Supported values are 'drive', 'appDataFolder' and 'photos'.default: drive
corporastringCorpora to query. 'user' for user's personal files, 'drive' for files in a specific shared drive (requires 'driveId'), 'domain' for files shared with the domain, 'allDrives' for all drives the user has access to.one of
user · drive · domain · allDrivesdriveIdstringID of the shared drive to search. Required if 'corpora' is 'drive'.
orderBystringA comma-separated list of sort keys. Valid keys are 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', and 'viewedByMeTime'. Each key sorts ascending by default, but may be reversed with the 'desc' modifier. Example: 'modifiedTime desc,name'.
pageSizeintegerThe maximum number of files to return per page.default: 100
pageTokenstringThe token for continuing a previous list request on the next page.
supportsAllDrivesbooleanWhether the requesting application supports both My Drives and shared drives. If 'includeItemsFromAllDrives' is true, this must also be true.default: true
includeItemsFromAllDrivesbooleanWhether both My Drive and shared drive items should be included in results. If true, 'supportsAllDrives' should also be true.default: false
GOOGLEDRIVE_FIND_FOLDERTool to find a folder in google drive by its name and optionally a parent folder. use when you need to locate a specific folder to perform further actions like creating files in it or listing its contents.7 params
Tool to find a folder in google drive by its name and optionally a parent folder. use when you need to locate a specific folder to perform further actions like creating files in it or listing its contents.
Parameters* required
starredbooleanSet to true to search for folders that are starred, or false for those that are not.
name_exactstringThe exact name of the folder to search for. This search is case-sensitive.
name_containsstringA substring to search for within folder names. This search is case-insensitive.
modified_afterstringSearch for folders modified after a specific date and time. The timestamp must be in RFC 3339 format (e.g., '2023-01-15T10:00:00Z' or '2023-01-15T10:00:00.000Z').
name_not_containsstringA substring to exclude from folder names. Folders with names containing this substring will not be returned. This search is case-insensitive.
full_text_containsstringA string to search for within the full text content of files within folders (if applicable and supported by Drive for the folder type or its contents). This search is case-insensitive.
full_text_not_containsstringA string to exclude from the full text content of files within folders. This search is case-insensitive.
GOOGLEDRIVE_GENERATE_IDSGenerates a set of file ids which can be provided in create or copy requests. use when you need to pre-allocate ids for new files or copies.3 params
Generates a set of file ids which can be provided in create or copy requests. use when you need to pre-allocate ids for new files or copies.
Parameters* required
typestringThe type of items for which the IDs can be used. For example, 'files' or 'shortcuts'.
countintegerThe number of IDs to return. Value must be between 1 and 1000, inclusive.
spacestringThe space in which the IDs can be used. Supported values are 'drive' and 'appDataFolder'.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
GOOGLE_CLIENT_ID*Google OAuth client ID (required for OAuth authentication modes)
GOOGLE_CLIENT_SECRETsecretGoogle OAuth client secret (optional for public clients)
GOOGLE_SERVICE_ACCOUNT_KEY_FILEPath to service account JSON key file (required for service-account auth mode)
AUTH_MODEAuthentication mode
HEADLESSdefault: falseDisable browser auto-open, return auth URL instead (true/false)
REDIRECT_URIOAuth redirect URI (optional, default: ephemeral loopback)
RESOURCE_STORE_URIResource store URI for exported files (file://)
PORTHTTP server port (overrides --port)
BASE_URLBase URL for HTTP transport (used for OAuth/DCR endpoints and file links)
LOG_LEVELLogging level
DCR_MODEdefault: self-hostedDynamic Client Registration mode
DCR_VERIFY_URLExternal verification endpoint URL (required for external DCR mode)
DCR_STORE_URIdefault: file://~/.mcp-z/mcp-drive/dcr.jsonDCR client storage URI (for self-hosted DCR mode)
Categories
Registryactive
Package@mcp-z/mcp-drive
TransportSTDIO, HTTP
AuthRequired
UpdatedJan 10, 2026
