Summary
The power editor for Google Workspace automation that goes where the official connector won't. Exposes 98 tools across Drive, Docs, Sheets, Slides, and GWS admin APIs, with deep Sheets operations that preserve formulas, charts, and conditional formatting instead of flattening everything to CSV. Built for shared drive governance and bulk operations: audit external permissions across drives, edit Slides presentations programmatically, run domain-wide delegation for org-scale automation. Supports OAuth, service accounts with DWD, and ADC. Ships with aggregation tools like `audit-shared-drive-permissions` and `summarize-spreadsheet` plus four MCP prompts for cleanup and bulk formatting workflows. Reach for this when you need write access to the full Workspace document model, not just read-only file listings.
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 Server
The Workspace power-editing MCP — formula-aware Sheets, full Slides editing, shared-drive audits the read-only Claude.ai connector deliberately won't ship.
98 tools across Drive, Docs, Sheets, Slides, GWS admin, and aggregations. Service Account + Domain-Wide Delegation for org-scale automation. GWS-aware capability detection — features auto-unlock for Workspace accounts.
What it does that others don't
- Deep Sheets editing — charts, conditional formats, protected ranges, named ranges, data validation, borders, merge, sort, find/replace, formulas, A1-quote-doubling for CJK tab names. The 1st-party Workspace connector reads Sheets as CSV — formulas don't survive.
- Full Slides editing — presentations, slides, shapes, tables, images, formatting. Not in the connector at all.
- Shared-Drive admin tooling —
list-shared-drives,get-shared-drive,create-shared-drive, list/share/remove permissions, file activity, labels, approvals. Workspace governance surface the connector deliberately doesn't expose. - 3 auth modes — OAuth2 (personal or GWS), Service Account + Domain-Wide Delegation (org-scale), Application Default Credentials (auto-detected).
- Aggregation tools —
audit-shared-drive-permissions(single Shared-Drive audit) +audit-external-shares(cross-drive / My-Drive audit with top external-domain concentration view),summarize-spreadsheet(metadata + per-tab sample + named ranges),summarize-doc(file + content + permissions + comments). - MCP Prompts (3) —
cleanup-shared-with-me,analyze-doc-structure,bulk-format-spreadsheet. - GWS-aware —
capabilities.tsdetects account type on startup; GWS-only tools return clear errors for personal accounts instead of mysterious 403s.
Try this — 5 prompts
Connect the server to Claude Desktop or Claude Code, then paste any of these:
- Shared-drive permission audit — "Audit external shares across all my Shared Drives. List people outside
us-all.co.krwho have access to anything. Group by drive, sort by access level." - Bulk conditional formatting — "Apply this conditional format to column
amountacross everysales-*spreadsheet in my drive: red if <0, yellow if 0–100, green if >100." - Slides from Doc outline — "Convert this Google Doc's outline into a 12-slide presentation: title slide, then 1 slide per H2 with H3 bullet points, end with a Q&A slide. Use the company template."
- Doc structure analysis — "Analyze this Doc's structure: heading hierarchy, internal vs external link health, image alt-text coverage. Suggest 3 concrete improvements."
- Cleanup shared-with-me — "Find files shared with me more than 180 days ago that I never opened. List them with sharer, last modified, and a guess at whether to keep."
When to use this vs alternatives
| Anthropic 1st-party Workspace connector | taylorwilsdon/google_workspace_mcp | xing5/mcp-google-sheets | @us-all/google-drive-mcp (this) | |
|---|---|---|---|---|
| Stars / availability | n/a (Claude.ai built-in, Feb 2026) | 2.3K★ | 836★ | — |
| Scope | Drive read + Sheets-as-CSV read | Gmail+Calendar+Drive+Docs+Sheets+Slides+Forms+Chat+Tasks+Contacts+Apps Script | Sheets only | Drive + Docs + Sheets + Slides + GWS admin |
| Sheets formula editing | ❌ (CSV round-trip loses formulas) | ✅ basic | ✅ specialist | ✅ deep (charts/conditional/named ranges) |
| Slides editing | ❌ | ✅ | ❌ | ✅ deep |
| Shared-drive admin | partial | ✅ | ❌ | ✅ deep |
| Folder operations | ❌ | ✅ | ❌ | ✅ |
| Aggregation tools | ❌ | ❌ | ❌ | ✅ summarize-spreadsheet, summarize-doc, audit-external-shares |
| MCP Prompts | ❌ | ❌ | ❌ | ✅ 4 |
| Auth modes | managed OAuth | OAuth + SA + stateless | SA / OAuth / ADC | OAuth + SA + DWD + ADC |
| Transport | n/a (Claude.ai-only) | stdio + HTTP | stdio | stdio |
Use the 1st-party connector for zero-config Drive read flows in Claude.ai. Use taylorwilsdon if you need the full Workspace surface (Gmail / Calendar / Forms etc.). Use this server for Drive + Docs + Sheets + Slides power-editing, shared-drive governance, and bulk operations the connector can't do.
Install
Claude Desktop
{
"mcpServers": {
"google-drive": {
"command": "npx",
"args": ["-y", "@us-all/google-drive-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "<your-client-id>",
"GOOGLE_CLIENT_SECRET": "<your-client-secret>",
"GOOGLE_REFRESH_TOKEN": "<your-refresh-token>"
}
}
}
}
Claude Code
claude mcp add google-drive -s user -- npx -y @us-all/google-drive-mcp
(Set env vars separately or in .mcp.json.)
Docker
docker run --rm -i --env-file .env ghcr.io/us-all/google-drive-mcp-server
Build from source
git clone https://github.com/us-all/google-drive-mcp-server.git
cd google-drive-mcp-server && pnpm install && pnpm build
node dist/index.js
Auth setup
OAuth2 (personal or GWS)
- Google Cloud Console → create project
- Enable Drive API, Docs API, Sheets API, Slides API, Drive Activity API, Drive Labels API
- Create OAuth2 credentials (Desktop App)
- Get a refresh token (OAuth2 playground or your own flow)
- Set
GOOGLE_CLIENT_ID,GOOGLE_CLIENT_SECRET,GOOGLE_REFRESH_TOKEN
Service Account + Domain-Wide Delegation (org-scale)
- Create a Service Account in Google Cloud Console
- Download the JSON key
- Workspace Admin Console → Security → API Controls → Domain-Wide Delegation → add the SA's Client ID + grant required scopes
- Set
GOOGLE_SERVICE_ACCOUNT_KEY_PATHandGOOGLE_IMPERSONATE_USER
Application Default Credentials (zero-config)
gcloud auth application-default login --client-id-file=client_secret.json --scopes=... — auto-detected on startup. Windows ADC paths (%APPDATA%\gcloud\) supported.
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
GOOGLE_CLIENT_ID | OAuth2 | — | OAuth2 Client ID |
GOOGLE_CLIENT_SECRET | OAuth2 | — | OAuth2 Client Secret |
GOOGLE_REFRESH_TOKEN | OAuth2 | — | OAuth2 Refresh Token |
GOOGLE_SERVICE_ACCOUNT_KEY_PATH | SA | — | Path to service-account JSON key |
GOOGLE_IMPERSONATE_USER | ❌ | — | GWS user email to impersonate (SA only) |
GOOGLE_DRIVE_ALLOW_WRITE | ❌ | false | Set true to enable mutations |
GOOGLE_DRIVE_SCOPES | ❌ | read-only Drive Activity + Docs scopes (or broader Drive/Docs scopes if write enabled) | Comma-sep OAuth scopes override |
GD_TOOLS | ❌ | — | Comma-sep allowlist of categories. Biggest token saver. |
GD_DISABLE | ❌ | — | Comma-sep denylist. Ignored when GD_TOOLS is set. |
MCP_TRANSPORT | ❌ | stdio | http to enable Streamable HTTP transport |
MCP_HTTP_TOKEN | conditional | — | Bearer token. Required when MCP_TRANSPORT=http |
MCP_HTTP_PORT | ❌ | 3000 | HTTP listen port |
MCP_HTTP_HOST | ❌ | 127.0.0.1 | HTTP bind host (DNS rebinding protection auto-enabled for localhost) |
MCP_HTTP_SKIP_AUTH | ❌ | false | Skip Bearer auth — e.g. behind a reverse proxy that handles it |
Categories (7): drive, sheets, docs, slides, shared-drives, labels, approvals. Plus always-on meta.
When MCP_TRANSPORT=http: POST /mcp (Bearer-auth JSON-RPC) + GET /health (public liveness).
Token efficiency
| Scenario | Tools | Schema tokens | vs default |
|---|---|---|---|
| default (all categories) | 96 | 18,400 | — |
typical (GD_TOOLS=drive,docs,sheets) | 68 | 13,700 | −25% |
narrow (GD_TOOLS=drive) | 25 | 4,000 | −78% |
extractFields projection on list-files/get-file/sheets-get-spreadsheet/docs-get-document (with tabsCount, rowCount, columnCount, locale, timeZone defaults). list-files slim default trims ~80% (drops capabilities 40-bool object + contentRestrictions).
GWS detection
capabilities.ts detects account type at startup via about.get() + domain check:
| Feature | Personal | GWS Standard+ | GWS Enterprise |
|---|---|---|---|
| File CRUD / Search / Export | ✅ | ✅ | ✅ |
| Docs / Sheets / Slides editing | ✅ | ✅ | ✅ |
| Comments & Revisions | ✅ | ✅ | ✅ |
| Drive Activity | ✅ | ✅ | ✅ |
| Shared Drives | — | ✅ | ✅ |
| Labels (classification) | — | ✅ | ✅ |
| Approvals | — | ✅ | ✅ |
| Domain-Wide Delegation | — | ✅ | ✅ |
GWS-only tools throw GWSFeatureError with a clear message for personal accounts — no mysterious 403s.
MCP Prompts (4)
Workflow templates available via MCP prompts/list:
audit-shared-drive-permissions— fleet-wide external-share audit; flag access-level outliers.cleanup-shared-with-me— find untouched stale shares + suggest cleanup.analyze-doc-structure— heading hierarchy + link health + alt-text coverage.bulk-format-spreadsheet— apply consistent format across many sheets/tabs.
MCP Resources
URI-based read-only access:
gdrive://file/{fileId}gdrive://spreadsheet/{spreadsheetId}gdrive://document/{documentId}gdrive://presentation/{presentationId}gdrive://folder/{folderId}gdrive://shared-drive/{driveId}(GWS-gated)gdrive://about/me
Tools (98)
7 categories. Use search-tools to discover at runtime; full list collapsed below.
| Category | Tools |
|---|---|
| Sheets (data / structure / formatting / advanced) | 30 |
| Drive (files / search / folders / permissions / export / comments / revisions / activity) | 24 |
| Slides (presentation / slide mgmt / content / formatting) | 20 |
| Docs (document / editing / formatting / elements) | 13 |
| GWS-only (shared drives / labels / approvals / audit) | 9 |
Aggregations (summarize-spreadsheet, summarize-doc, audit-external-shares) | 3 |
Meta (search-tools) | 1 |
Full tool list
Drive (24)
get-about, list-files, get-file, read-file, create-file, update-file, copy-file, delete-file, search-files, create-folder, move-file, get-folder-tree, list-permissions, share-file, remove-permission, export-file, get-download-link, list-comments, get-comment, create-comment, resolve-comment, list-revisions, get-revision, get-activity
Google Docs (13)
Document: docs-get-document, docs-create-document, docs-get-content, docs-list-tabs
Editing: docs-insert-text, docs-delete-range, docs-replace-text, docs-batch-update
Formatting: docs-format-text, docs-format-paragraph
Elements: docs-insert-table, docs-insert-image, docs-insert-page-break
Google Sheets (30)
Data: sheets-get-spreadsheet, sheets-get-values, sheets-batch-get-values, sheets-update-values, sheets-batch-update-values, sheets-append-values, sheets-clear-values, sheets-batch-clear-values, sheets-create-spreadsheet, sheets-manage-sheets
Structure: sheets-insert-dimension, sheets-delete-dimension, sheets-duplicate-sheet, sheets-copy-sheet-to, sheets-copy-paste, sheets-sort-range, sheets-find-replace
Formatting: sheets-format-cells, sheets-update-borders, sheets-merge-cells, sheets-unmerge-cells, sheets-auto-resize, sheets-resize-dimensions
Advanced: sheets-set-data-validation, sheets-add-conditional-format, sheets-add-chart, sheets-delete-chart, sheets-add-protected-range, sheets-delete-protected-range, sheets-manage-named-range
Google Slides (20)
Presentation: slides-get-presentation, slides-create-presentation, slides-duplicate-presentation
Slide management: slides-get-slide, slides-add-slide, slides-delete-slide, slides-move-slide, slides-duplicate-slide
Content: slides-insert-text, slides-replace-text, slides-insert-text-box, slides-insert-image, slides-insert-table, slides-update-table-cell, slides-insert-shape
Formatting: slides-format-text, slides-format-shape, slides-resize-element, slides-set-slide-background, slides-batch-update
GWS-only (9)
list-shared-drives, get-shared-drive, create-shared-drive, audit-shared-drive-permissions, list-file-labels, apply-label, remove-label, list-approvals, get-approval
Aggregations
summarize-spreadsheet, summarize-doc, audit-external-shares
audit-external-shares complements the GWS-only audit-shared-drive-permissions: it runs across all corpora the caller can see (or just My Drive on personal accounts) and adds a top-external-domains concentration view.
Meta
search-tools — query other tools by keyword; always enabled.
Architecture
Claude → MCP stdio → src/index.ts
├── config.ts (OAuth2 / SA / ADC)
├── capabilities.ts (Personal vs GWS detect)
├── client.ts (Google API auth)
└── tools/{files,search,folders,permissions,export,comments,revisions,
about,activity,docs,sheets,slides,shared-drives,labels,approvals,
aggregations}.ts
↓
Drive API v3 / Docs API v1 / Sheets API v4 /
Slides API v1 / Drive Activity API v2 / Drive Labels API v2
Built on @us-all/mcp-toolkit:
extractFields— token-efficient response projectionsaggregate(fetchers, caveats)— fan-out helper forsummarize-doccreateWrapToolHandler— Google query-stringkey=...redaction +WriteBlockedError/GWSFeatureErrorpassthrough + Google API error extractionsearch-toolsmeta-tool
supportsAllDrives: true is passed to every Drive API call so Shared Drives just work.
Tech stack
Node.js 22+ • TypeScript strict ESM • pnpm • @modelcontextprotocol/sdk • googleapis (Drive v3 / Docs v1 / Sheets v4 / Slides v1 / Activity v2 / Labels v2) • zod • dotenv • vitest.
Limitations
- Approvals API —
googleapisSDK has no typed bindings; uses rawfetchwith auth header extraction. search-files— auto-wraps plain text infullText contains '...'; pass Drive query syntax directly for advanced searches.
License
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_IDsecretOAuth client ID. Required for OAuth refresh-token auth method.
GOOGLE_CLIENT_SECRETsecretOAuth client secret. Required for OAuth refresh-token auth method.
GOOGLE_REFRESH_TOKENsecretOAuth refresh token. Required for OAuth refresh-token auth method.
GOOGLE_APPLICATION_CREDENTIALSPath to service account JSON key. Required for SA + DWD auth method (alternative to OAuth).
GOOGLE_SERVICE_ACCOUNT_KEY_PATHAlias for GOOGLE_APPLICATION_CREDENTIALS.
GOOGLE_IMPERSONATE_USERWorkspace user email to impersonate (DWD). Required when using service account auth.
GOOGLE_DRIVE_SCOPESComma-separated OAuth scopes. Defaults are read-only; write mode broadens Drive/Docs scopes as needed.
GOOGLE_DRIVE_ALLOW_WRITEdefault: falseSet to 'true' to enable write tools. Default read-only.
GD_TOOLSComma-separated category allowlist. Default: all categories enabled.
GD_DISABLEComma-separated category disablelist.
Categories
Registryactive
Package@us-all/google-drive-mcp
TransportSTDIO
AuthRequired
UpdatedMay 30, 2026
