`drive_list_files`

Pack: google_drive · Endpoint: https://gateway.pipeworx.io/google_drive/mcp

List files in your Google Drive. Optionally filter by name, type, owner, or modified date (e.g., ‘name contains “report”’). Returns file names, IDs, types, and metadata.

Parameters

Name	Type	Required	Description
`q`	string	no	Drive search query (e.g., “name contains ‘report’” or “mimeType=‘application/pdf’“)
`page_size`	number	no	Maximum number of files to return (default 10, max 100)
`page_token`	string	no	Token for fetching the next page of results
`order_by`	string	no	Sort order (e.g., “modifiedTime desc”, “name”)

Example call

Arguments

{
  "page_size": 10
}

curl

curl -X POST https://gateway.pipeworx.io/google_drive/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"drive_list_files","arguments":{"page_size":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('drive_list_files', {
  "page_size": 10
});

More examples

{
  "q": "name contains 'report'",
  "page_size": 20,
  "order_by": "modifiedTime desc"
}

Response shape

Field	Type	Description
`nextPageToken`	string	Token for fetching the next page of results
`files`	array	List of files matching the query
`error`	string	Error code if connection failed
`message`	string	Error message with instructions

Full JSON Schema

{
  "type": "object",
  "properties": {
    "nextPageToken": {
      "type": "string",
      "description": "Token for fetching the next page of results"
    },
    "files": {
      "type": "array",
      "description": "List of files matching the query",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "File ID"
          },
          "name": {
            "type": "string",
            "description": "File name"
          },
          "mimeType": {
            "type": "string",
            "description": "MIME type of the file"
          },
          "size": {
            "type": "string",
            "description": "File size in bytes"
          },
          "createdTime": {
            "type": "string",
            "description": "ISO 8601 creation timestamp"
          },
          "modifiedTime": {
            "type": "string",
            "description": "ISO 8601 last modified timestamp"
          },
          "owners": {
            "type": "array",
            "description": "List of file owners",
            "items": {
              "type": "object",
              "properties": {
                "displayName": {
                  "type": "string",
                  "description": "Owner display name"
                },
                "emailAddress": {
                  "type": "string",
                  "description": "Owner email address"
                }
              }
            }
          },
          "webViewLink": {
            "type": "string",
            "description": "URL to open file in Google Drive web interface"
          }
        }
      }
    },
    "error": {
      "type": "string",
      "description": "Error code if connection failed"
    },
    "message": {
      "type": "string",
      "description": "Error message with instructions"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "google_drive": {
      "url": "https://gateway.pipeworx.io/google_drive/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

drive_list_files