List, upload and download files on Google Drive using an OAuth2 token kept in the vault, never in code.
The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.
Jump to:
check_authlist_filesuploaddownload
check_auth
Verify the stored Google Drive credentials work by calling about.get, without listing or touching any files.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
profile |
profile |
optional, default google_drive
|
| Name | Type | Notes |
|---|---|---|
ok |
bool | |
email |
string | |
name |
string | |
storage_used |
int | |
storage_limit |
int |
list_files
List files on Google Drive, optionally scoped to a parent folder id and/or a name search.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
folder_id |
string |
optional, default ""
|
|
query |
string |
optional, default ""
|
|
profile |
profile |
optional, default google_drive
|
| Name | Type | Notes |
|---|---|---|
files |
json | |
count |
int |
upload
Destructive
Upload a single local file to Google Drive, optionally into a parent folder id.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
file |
path | required | |
folder_id |
string |
optional, default ""
|
|
profile |
profile |
optional, default google_drive
|
| Name | Type | Notes |
|---|---|---|
file_id |
string | |
name |
string | |
url |
string | |
bytes |
int |
download
Download one Google Drive file by id into a local output folder. Native Google Docs/Sheets/Slides files are not supported (export them from Drive first).
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
file_id |
string | required | |
out_dir |
path | required | |
profile |
profile |
optional, default google_drive
|
| Name | Type | Notes |
|---|---|---|
file |
path | |
name |
string | |
bytes |
int |
python app.py --action check_auth --params '{}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("google-drive", "check_auth", {}){
"id": "n0",
"app": "google-drive",
"action": "check_auth",
"params": {},
"inputs": {}
}python app.py --action list_files --params '{}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("google-drive", "list_files", {}){
"id": "n0",
"app": "google-drive",
"action": "list_files",
"params": {},
"inputs": {}
}python app.py --action upload --params '{"file": "D:/path/to/file"}'
# preview first - destructive action, nothing is changed:
python app.py --action upload --params '{"file": "D:/path/to/file"}' --dry-runRun from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("google-drive", "upload", {"file": "D:/path/to/file"})
# preview first:
run_action("google-drive", "upload", {"file": "D:/path/to/file"}, dry_run=true){
"id": "n0",
"app": "google-drive",
"action": "upload",
"params": {
"file": "D:/path/to/file"
},
"inputs": {}
}python app.py --action download --params '{"file_id": "<file_id>", "out_dir": "D:/path/to/out_dir"}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("google-drive", "download", {"file_id": "<file_id>", "out_dir": "D:/path/to/out_dir"}){
"id": "n0",
"app": "google-drive",
"action": "download",
"params": {
"file_id": "<file_id>",
"out_dir": "D:/path/to/out_dir"
},
"inputs": {}
}Things you can say to Claude, Cursor or Codex once the MCP server is registered.