Google Drive

Inputs:

• oauth_token (object, required) — Valid Google OAuth token object with credentials
• folder_id (string, optional) — Specific folder ID to list files from (default: null)
• query (string, optional) — Search query string for filtering (default: "")
• page_size (integer, optional) — Maximum items per page (default: 10)

Output:

{
  "result": {
    "count": 5,
    "files": [
      {
        "id": "file-id-123",
        "name": "document.pdf",
        "mimeType": "application/pdf"
      }
    ]
  }
}

Usage Example:

POST /mcp/google-drive/list_files
 
{
  "oauth_token": {
    "token": "ya29.a0AfH6SMxxxxxxxxxxxxxx",
    "refresh_token": "1//0xxxxx",
    "token_uri": "https://oauth2.googleapis.com/token",
    "client_id": "xxx.apps.googleusercontent.com",
    "client_secret": "xxxxx",
    "scopes": ["https://www.googleapis.com/auth/drive"]
  },
  "folder_id": "abc123xyz",
  "page_size": 10

Inputs:

• oauth_token (object, required) — Valid Google OAuth token object
• file_id (string, required) — The file ID to retrieve metadata for

Output:

{
  "result": {
    "id": "file-id-123",
    "name": "document.pdf",
    "mimeType": "application/pdf",
    "size": "1024000",
    "createdTime": "2026-03-19T10:00:00Z",

Inputs:

• oauth_token (object, required) — Valid Google OAuth token object
• file_id (string, required) — The file ID to download
• destination_path (string, required) — Local file path where file will be saved

Output:

{
  "result": {
    "message": "File downloaded successfully to /path/to/file"
  }
}

Usage Example:

Inputs:

• oauth_token (object, required) — Valid Google OAuth token object
• file_path (string, required) — Local file path to upload
• name (string, optional) — Custom name for the file in Drive (default: null)
• folder_id (string, optional) — Target folder ID in Drive (default: null)
• mime_type (string, optional) — MIME type of the file (default: null)

Output:

{
  "result": {
    "message": "File uploaded successfully",
    "file": {
      "id": 

Inputs:

• oauth_token (object, required) — Valid Google OAuth token object
• name (string, required) — Name of the new folder
• parent_folder_id (string, optional) — Parent folder ID (default: null, creates in root)

Output:

{
  "result": {
    "message": "Folder created successfully",
    "folder": {
      "id": "folder-id-456",
      "name": "New Folder",
      "mimeType": 

Inputs:

• oauth_token (object, required) — Valid Google OAuth token object
• file_id (string, required) — The file or folder ID to delete

Output:

{
  "result": {
    "message": "File deleted successfully"
  }
}

Usage Example:

POST /mcp/google-drive/delete_file
 
{
  "oauth_token"

Inputs:

• oauth_token (object, required) — Valid Google OAuth token object
• query (string, required) — Search query using Drive API query syntax
• page_size (integer, optional) — Maximum items per page (default: 10)

Output:

{
  "result": {
    "count": 3,
    "files": [
      {
        "id": "file-id-789",
        "name": "report.docx",

Inputs:

• oauth_token (object, required) — Valid Google OAuth token object
• file_id (string, required) — The file ID to share
• email (string, optional) — Email address to share with (default: null)
• role (string, optional) — Permission level: "reader", "commenter", or "writer" (default: "reader")
• share_type (string, optional) — Type of sharing: "user", "group", "domain", or "anyone" (default: null)

Output:

{
  "result": {
    "message": "File shared successfully",
    "permission_id": "perm-id-123"

Inputs:

• oauth_token (object, required) — Valid Google OAuth token object
• file_id (string, required) — The text file ID to retrieve content from

Output:

{
  "result": "File content as raw text string"
}

Usage Example:

POST /mcp/google-drive/get_file_content
 
{
  "oauth_token": {
    "token"

Pagination

• page_size — Maximum results per page (default: 10)
• page_token — Token from previous response for paginating through results

Query & Filtering

• query — Drive API query filter (e.g., name contains 'report', mimeType = 'application/pdf')

Resource Formats

File Resource:

files/{FILE_ID}
Example: files/abc123xyz789def456

Folder Resource:

All tools require a valid Google OAuth token. Here's how to obtain one:

Step 1: Create Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Google Drive API from the API Library

Step 2: Create OAuth 2.0 Credentials

1. Navigate to Credentials in Google Cloud Console
2. Click + Create Credentials → OAuth client ID
3. Select your application type (Desktop, Web, or other)
4. Download the credentials JSON file

Step 3: Authenticate with Google

Use your Google account to authenticate and obtain the OAuth token. Refer to Google OAuth 2.0 Documentation for detailed authentication steps specific to your use case.

Step 4: Required Scopes

Ensure your OAuth token has these scopes:

• https://www.googleapis.com/auth/drive — Full Drive access (read, write, delete)
• https://www.googleapis.com/auth/drive.file — Access only to files created by the app
• https://www.googleapis.com/auth/drive.readonly — Read-only access to all files

Missing or Invalid API Key

• Cause: API key not provided in request headers or incorrect format
• Solution:
  1. Verify Authorization: Bearer YOUR_API_KEY header is present
  2. Check API key is active in your Curious Layer account
  3. Regenerate API key if expired

Rate Limit Exceeded

• Cause: Too many requests sent to the API gateway
• Solution:
  1. Check rate limit headers in response: X-RateLimit-Remaining
  2. Implement exponential backoff for retries
  3. Spread requests over time

Insufficient Credits

• Cause: API calls have exceeded your requests limits
• Solution:
  1. Check credit usage in your Curious Layer dashboard
  2. Upgrade to a paid plan or add credits for higher limits
  3. Contact support for credit adjustments

Malformed Request Payload

• Cause: JSON payload is invalid or missing required fields
• Solution:
  1. Validate JSON syntax before sending
  2. Ensure all required tool parameters are included

• Google Drive API Documentation — Official API reference
• Google Cloud OAuth 2.0 — Authentication setup guide
• Google Drive API Reference — Complete API endpoint reference
• FastMCP Docs — FastMCP specification