mcp-gdrive mcp

v1.1.0 · MCP Tool · cloud_storage · registry.pascalai.org

Google Drive API v3. Operations: list/search (query), get (metadata), download (to local_path), upload (local file), create_folder, move (file_id + parent_id), copy, rename, delete, share (email + role), permissions. Auth via access_token or GOOGLE_ACCESS_TOKEN env var; auto-refresh with refresh_token+client_id+client_secret.

gdrivegoogledrivecloudfilesstorageoauth2

Input Parameters

ParameterTypeDescription
operationrequired string Operation to perform. Default: list. 'search' is alias for 'list' with a query. One of: list, get, download, upload, create_folder, move, copy, rename, delete, share, permissions, search.
accessTokenoptional string OAuth2 access token. Can also be set via GOOGLE_ACCESS_TOKEN env var.
refreshTokenoptional string OAuth2 refresh token for auto-refresh. Can also be set via GOOGLE_REFRESH_TOKEN env var.
clientIdoptional string OAuth2 client ID for token refresh. Can also be set via GOOGLE_CLIENT_ID env var.
clientSecretoptional string OAuth2 client secret for token refresh. Can also be set via GOOGLE_CLIENT_SECRET env var.
fileIdoptional string File or folder ID. Required for get, download, move, copy, rename, delete, share, permissions.
nameoptional string File or folder name. Required for upload and create_folder. Optional for copy (new copy name).
queryoptional string Drive search query for list/search. Examples: "name contains 'report'", "mimeType='application/pdf'", "trashed=false", "'folderId' in parents".
parentIdoptional string Parent folder ID for upload, create_folder, or move destination. Default: root.
localPathoptional string Local file path. For upload: source file. For download: destination path.
mimeTypeoptional string MIME type for upload. Auto-detected from file extension if omitted.
emailoptional string Email address to share with. Required for share operation.
roleoptional string Permission role for share operation. Default: reader. One of: reader, commenter, writer, owner. Default: reader.
newNameoptional string New file name for rename operation.
maxResultsoptional integer Max files to return for list/search. Default: 20. Default: 20.
pageTokenoptional string Page token for pagination (from previous response's nextPageToken).
fieldsoptional string Fields to return per file. Default: id,name,mimeType,size,modifiedTime,parents,webViewLink.

Output Fields

FieldTypeDescription
files array[object]
nextPageToken string
id string
name string
mimeType string
ok boolean
file_id string
local_path string
size_bytes integer
permissions array[object]

Examples

List files in root

// Input
{
  "operation": "list",
  "accessToken": "ya29.xxx",
  "maxResults": 10
}

// Output
{
  "files": [],
  "nextPageToken": ""
}

Search for PDF files

// Input
{
  "operation": "search",
  "accessToken": "ya29.xxx",
  "query": "mimeType='application/pdf' and trashed=false"
}

// Output
{
  "files": []
}

Upload a file

// Input
{
  "operation": "upload",
  "accessToken": "ya29.xxx",
  "localPath": "C:\\reports\\jan.pdf",
  "name": "jan.pdf",
  "parentId": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms"
}

// Output
{
  "id": "1abc...",
  "name": "jan.pdf",
  "mimeType": "application/pdf"
}

Share a file with a user

// Input
{
  "operation": "share",
  "accessToken": "ya29.xxx",
  "fileId": "1abc...",
  "email": "colleague@example.com",
  "role": "writer"
}

// Output
{
  "id": "perm123",
  "type": "user",
  "role": "writer"
}

Install & Discovery

Install

ppm install mcp-gdrive

Get JSON Schema

GET /v1/packages/mcp-gdrive/1.1.0/schema

Discover by keyword

GET /v1/mcp/discover?q=gdrive
Discovery hint: Install with ppm install mcp-gdrive or invoke remotely via POST /v1/invoke/mcp-gdrive on the MCP Service.