gdrive_read_file
Google Drive · macOS · Windows
Effect: read (strongest supported action). Status: gated.
Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.
macOS
Purpose
Reads a text file from the synced Google Drive folder (.txt, .md, .csv, .json, code files...). Note: native Google Docs/Sheets/Slides sync as .gdoc/.gsheet pointers, not real files — export them from Drive or read Office/PDF copies instead. Auto-detects UTF-8 with Latin-1/CP1252 fallback. For files outside Google Drive, use file_read.
Required inputs
path— Absolute path to the file
Permissions and confirmation
No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — macOS
{
"properties": {
"encoding": {
"description": "'auto' (default), 'utf8', 'latin1', 'cp1252', 'ascii', 'utf16'",
"type": "string"
},
"max_bytes": {
"description": "Max bytes (default 1MB, cap 10MB)",
"type": "integer"
},
"offset": {
"description": "Start byte offset (default 0)",
"type": "integer"
},
"path": {
"description": "Absolute path to the file",
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"path": "/Users/demo/Library/CloudStorage/[email protected]/My Drive/Documents/meeting-notes.txt"
}Windows
Purpose
Reads a text file from Google Drive. Returns the content as text.
Required inputs
path— File path (relative to Google Drive root or absolute)
Permissions and confirmation
No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — Windows
{
"properties": {
"path": {
"description": "File path (relative to Google Drive root or absolute)",
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"path": "Documents/meeting-notes.txt"
}