gdrive-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| XDG_CONFIG_HOME | No | Base config directory. Default: ~/.config | ~/.config |
| GDRIVE_MCP_TOKEN | No | Path to cached per-user OAuth token. Default: ~/.config/gdrive-mcp/token.json | ~/.config/gdrive-mcp/token.json |
| GDRIVE_MCP_AUDIT_LOG | No | Path to audit log file. Default: audit.log in the config dir. | |
| GDRIVE_MCP_FILES_DIR | No | Sandbox directory for local file I/O (downloads, exports, uploads). Default: ~/.config/gdrive-mcp/files | ~/.config/gdrive-mcp/files |
| GDRIVE_MCP_OAUTH_CLIENT | No | Path to the Desktop-app OAuth client JSON file. Default: ~/.config/gdrive-mcp/oauth_client.json | ~/.config/gdrive-mcp/oauth_client.json |
| GDRIVE_MCP_CALLING_MODEL | No | Operator-controlled caller-model pin, used when the client does not send _meta.model. | |
| GDRIVE_MCP_FILES_TTL_HOURS | No | Age in hours after which spilled sandbox files are swept on server start; '0' disables. Default: '24' | 24 |
| GDRIVE_MCP_OAUTH_CLIENT_CMD | No | Command that prints the OAuth client JSON. Alternative to GDRIVE_MCP_OAUTH_CLIENT. | |
| GDRIVE_MCP_REQUIRE_VERIFICATION | No | Set to 'always' to gate every call regardless of model (anti-delegation hard override). | |
| GDRIVE_MCP_VERIFICATION_MODEL_PATTERNS | No | Comma-separated model-name substrings that require per-call verification. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| resolve_linkA | Resolve a Google Drive/Docs/Sheets URL or bare ID (item) to its id, kind, name and link. |
| search_filesA | Search Drive by name, full-text content, mime type, and/or parent folder. |
| list_folderA | List the direct children of a folder (item = folder URL or ID). |
| get_metadata | Full metadata for a file: owner, timestamps, size, parents, sharing link. |
| read_sheet | Preview a spreadsheet (item = URL or ID): the first max_rows x max_cols (default 5x5) of each tab. |
| read_full_sheetA | Read an entire sheet tab, save it to a local CSV, and return the path + a 5x5 preview. |
| write_sheetA | Write rows to a tab of a spreadsheet (item), starting at start_cell (default A1). |
| append_rowsA | Append rows after the last row of a tab of a spreadsheet (item). Non-destructive. |
| format_cellsA | Set text formatting (bold/italic/underline) on a bounded A1 range of a spreadsheet (item). |
| create_spreadsheetB | Create a new spreadsheet with optional named tabs. |
| add_tab | Add a new tab (sheet) to an existing spreadsheet (item). |
| clear_rangeA | Clear all values in an A1 range of a spreadsheet (item), e.g. 'Data!A2:C10'. Requires confirm=true. |
| delete_rows | Delete |
| read_documentA | Read a Google Doc (item = URL or ID) as 'markdown' (default) or 'text', one bounded chunk at a time. |
| extract_images | Extract embedded images from a Google Doc (item = URL or ID) as viewable images, in order. |
| create_documentA | Create a new Google Doc (in My Drive root), optionally with initial text content. |
| append_text | Append text to the end of a Google Doc (item = URL or ID). |
| insert_text | Insert text at a character index in a Google Doc (item = URL or ID). |
| read_commentsA | List comments on a Doc or file (item = URL or ID). |
| add_comment | Add an (unanchored) comment to a Doc or file (item = URL or ID). |
| read_file_as_textA | Read a file's content as text, one bounded chunk at a time. |
| download_file | Download a binary file. Small (<5MB, no dest_path) → base64 inline; otherwise written to
the sandbox files dir (dest_path is resolved inside it; absolute/ |
| upload_file | Create a new Drive file (from source_path or text content), or replace an existing file's
content (replace_id — requires confirm=true). |
| move_file | Move a file (item) into a different folder (parent). Requires confirm=true. |
| rename_fileC | Rename a file. Requires confirm=true. |
| export_file | Export a Google-native file to a format: pdf, docx, xlsx, pptx, csv, txt, md, html. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Each tool targets a distinct action on a specific resource (e.g., append_rows vs write_sheet, read_document vs read_file_as_text) with clear scoping, eliminating ambiguity.
All tools follow a consistent verb_noun snake_case pattern (e.g., create_document, search_files, rename_file) with no deviations.
14 tools cover the essential operations for Google Drive, Docs, and Sheets without being overwhelming or sparse.
Solid for Sheets (CRUD + format/append/clear) but missing create_folder, delete/organize files, and update document content beyond creation, leaving notable gaps.