Summary
Connects Claude to Google Drive through an OAuth proxy architecture that handles all the token exchange without storing credentials. You get file operations (list, search, upload, download, move, trash), folder creation, comments and replies, and permission management. The file download tool can export native Google Docs and Sheets formats. Search uses Drive's query syntax so you can filter by name, MIME type, folder parent, or ownership. Runs as an HTTP server on localhost and manages the full OAuth flow from authorization through to API calls. Pair it with the author's google-docs-mcp or google-sheets-mcp servers if you need to edit document contents beyond what Drive's API provides.
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'.
google-drive-mcp
MCP server for Google Drive - list, search, upload, download, and manage files and folders.
Use Cases
Answer from files: "What was our revenue target in the Q2 board deck?" → searches Drive, reads the relevant doc, and answers your question.
Project scaffolding: Starting a new vendor onboarding → creates a folder structure with subfolders for contracts, compliance, deliverables, and meeting notes, plus template docs and sheets.
Feedback synthesis: "Summarize the feedback from my manager across my last 10 presentation decks" → reads comments from multiple files and identifies themes and development areas.
Localization workflow: "We're onboarding contractors in Japan - translate the onboarding folder from English to Japanese and flag anything that needs local adaptation (HR policies, holidays, etc.)" → reads multiple docs, translates, and highlights areas needing review.
(These are just examples - any workflow that needs file search, reading, or organization can use this. Use in combination with google-docs-mcp for reading/editing Google Docs, or google-sheets-mcp for Google Sheets.)
Setup
1. Create Google OAuth credentials
- Go to Google Cloud Console
- Create a new project (or use existing)
- Enable the Google Drive API
- Go to APIs & Services → OAuth consent screen, set up consent screen
- Go to APIs & Services → Credentials → Create Credentials → OAuth client ID
- Choose Web application
- Add
http://localhost:3000/callbackto Authorized redirect URIs - Note your Client ID and Client Secret
2. Run the server
GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start
The server runs on http://localhost:3000 by default. Change with PORT=3001.
3. Add to your MCP client
claude mcp add --transport http google-drive-mcp http://localhost:3000/mcp
Architecture
This server acts as an OAuth proxy to Google:
graph LR
A[MCP client] <--> B[google-drive-mcp] <--> C[Google OAuth/API]
- Server advertises itself as an OAuth authorization server via
/.well-known/oauth-authorization-server /registerreturns the Google OAuth client credentials/authorizeredirects to Google, encoding the client's callback URL in state/callbackreceives the code from Google and forwards to the client's callback/tokenproxies token requests to Google, injecting client credentials/mcphandles MCP requests, using the bearer token to call Drive API
The server holds no tokens or state - it just proxies OAuth to Google.
Tools
| Tool | Description |
|---|---|
| Files | |
files_list | List/search files using Drive query syntax |
file_get | Get file metadata |
file_download | Download file content (supports export for Google Docs/Sheets) |
file_upload | Upload a new file |
file_update | Update file content or metadata |
file_copy | Copy a file |
file_move | Move a file to a different folder |
file_trash | Move to trash |
file_untrash | Restore from trash |
file_delete | Permanently delete |
| Folders | |
folder_create | Create a new folder |
| Comments | |
comments_list | List comments on a file |
comment_get | Get a comment and its replies |
comment_create | Add a comment to a file |
comment_reply | Reply to a comment |
comment_resolve | Resolve or unresolve a comment |
| Replies | |
replies_list | List replies to a comment |
reply_get | Get a specific reply |
reply_update | Update a reply |
reply_delete | Delete a reply |
| Permissions | |
permissions_list | List who has access to a file |
permission_get | Get a specific permission |
permission_create | Share a file with a user, group, domain, or anyone |
permission_update | Change a user's access level |
permission_delete | Revoke access to a file |
Drive Query Syntax
The files_list tool supports Drive's query syntax for filtering:
# By name
name contains 'report'
name = 'Budget 2024'
# By type
mimeType = 'application/pdf'
mimeType = 'application/vnd.google-apps.folder'
mimeType = 'application/vnd.google-apps.document'
# By folder
'folder-id' in parents
# By ownership
'user@example.com' in owners
# Combined
name contains 'report' and mimeType = 'application/pdf'
Google Drive API Scopes
drive- Full access to Drive files
Contributing
Pull requests are welcomed on GitHub! To get started:
- Install Git and Node.js
- Clone the repository
- Install dependencies with
npm install - Run
npm run testto run tests - Build with
npm run build
Releases
Versions follow the semantic versioning spec.
To release:
- Use
npm version <major | minor | patch>to bump the version - Run
git push --follow-tagsto push with tags - Wait for GitHub Actions to publish to the NPM registry.
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_ACCESS_TOKEN*secretGoogle OAuth access token with Drive scopes.
MCP_TRANSPORT*Transport type.
GOOGLE_CLIENT_ID*Google OAuth client ID.
GOOGLE_CLIENT_SECRET*secretGoogle OAuth client secret.
Registryactive
Packagegoogle-drive-mcp
TransportSTDIO, HTTP
AuthRequired
UpdatedMay 25, 2026
