---
title: "List user's Google Drive files"
method: GET
path: "/api/v1/drive/files"
---

# List user's Google Drive files

`GET /api/v1/drive/files`

## Request

- Base URL: `https://localhost:3000`
- URL: `https://localhost:3000/api/v1/drive/files`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`)

AUTHORITATIVE: Returns LIVE list of files from the authenticated user's actual Google Drive. Use when user asks 'show my files', 'what's in my Drive', 'my recent files'. Supports pagination - use nextPageToken to iterate through large drives without loading everything at once.

## Query parameters

- `max_results` integer
- `page_token` string
- `mime_type` string
- `folder_id` string

## Response `200`

LIVE file list from user's Drive

- DriveFilesResponse
  - `user` string
  - `files` DriveFile[]
    - `id` string: Google Drive file ID
    - `name` string: File name
    - `mimeType` string: MIME type of the file
    - `webViewLink` string: Link to view the file in browser
    - `modifiedTime` string, date-time: Last modified timestamp
    - `size` string: File size in bytes
    - `parents` string[]: Parent folder IDs
  - `count` integer: Number of files in this page
  - `nextPageToken` string: Token to get next page (null if no more pages)
  - `hasMore` boolean: Whether more files are available
  - `pageInfo` object
    - `returnedCount` integer
    - `requestedPageSize` integer
    - `filters` object
      - `mimeType` string
      - `folderId` string

## Other responses

- `401`: Authentication required
- `500`: Internal server error

---

[API](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api.md) · [All operations](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/revisions/e25648ba6027?raw)