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

# Search user's Google Drive files

`GET /api/v1/drive/search`

## Request

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

AUTHORITATIVE: Search the authenticated user's LIVE Google Drive files by name or content. Use when user asks 'find my file about X', 'search my Drive for Y'. Returns real results from user's actual Drive account. Supports pagination for large result sets.

## Query parameters

- `query` string, required
- `max_results` integer
- `page_token` string

## Response `200`

Search results

- DriveSearchResponse
  - `user` string: Authenticated user email
  - `query` string: The search query used
  - `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 of results (null if no more pages)
  - `hasMore` boolean: Whether more results are available
  - `_meta` object
    - `source` string
    - `authoritative` boolean

## 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)