> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Drive File Search

> Search and inspect Drive files with structured output.

```python file_search.py theme={null}
"""
Drive File Search
=================
Search and inspect Drive files with structured output.

The agent searches Drive, fetches metadata, and returns a structured report.

Key concepts:
- output_schema: Forces structured JSON matching FileSearchResult
- search_files: Returns full metadata including parents, description, and links

Setup:
1. Create OAuth credentials at https://console.cloud.google.com (enable Google Drive API)
2. Export GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_PROJECT_ID env vars
3. pip install openai google-api-python-client google-auth-httplib2 google-auth-oauthlib
4. First run opens browser for OAuth consent, saves token.json for reuse
"""

from typing import List, Optional

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.google.drive import GoogleDriveTools
from pydantic import BaseModel, Field


class FileInfo(BaseModel):
    file_id: str = Field(..., description="Google Drive file ID")
    name: str = Field(..., description="File name")
    mime_type: str = Field(..., description="MIME type")
    modified: str = Field(..., description="Last modified timestamp")
    owner: Optional[str] = Field(None, description="File owner name or email")
    parents: Optional[List[str]] = Field(None, description="Parent folder IDs")
    description: Optional[str] = Field(
        None, description="File description set by the owner"
    )
    web_link: Optional[str] = Field(None, description="Web view link")
    download_link: Optional[str] = Field(None, description="Direct download link")


class FileSearchResult(BaseModel):
    query: str = Field(..., description="The search query used")
    total_found: int = Field(..., description="Number of files found")
    files: List[FileInfo] = Field(default_factory=list, description="Matching files")


agent = Agent(
    name="Drive Search Agent",
    model=OpenAIResponses(id="gpt-5.5"),
    tools=[GoogleDriveTools()],
    instructions=[
        "Search for files matching the user's criteria.",
        "search_files returns full metadata including parents, description, and links.",
    ],
    output_schema=FileSearchResult,
)

# ---------------------------------------------------------------------------
# Run Demo
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    agent.print_response("Find all PDF files in my Drive")

    # Search by name pattern
    # agent.print_response("Search for files with 'report' in the name")

    # Search within a folder
    # agent.print_response("What files are inside the folder called 'Projects'?")
```

## Run the Example

<Steps>
  <Snippet file="create-venv-step.mdx" />

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U agno google-api-python-client google-auth google-auth-httplib2 google-auth-oauthlib openai openpyxl python-docx python-pptx
    ```
  </Step>

  <Step title="Export your API keys">
    <CodeGroup>
      ```bash Mac/Linux theme={null}
      export GOOGLE_CLOUD_QUOTA_PROJECT_ID="your_google_cloud_quota_project_id_here"
      export OPENAI_API_KEY="your_openai_api_key_here"
      ```

      ```bash Windows theme={null}
      $Env:GOOGLE_CLOUD_QUOTA_PROJECT_ID="your_google_cloud_quota_project_id_here"
      $Env:OPENAI_API_KEY="your_openai_api_key_here"
      ```
    </CodeGroup>
  </Step>

  <Step title="Run the example">
    Save the code above as `file_search.py`, then run:

    ```bash theme={null}
    python file_search.py
    ```
  </Step>
</Steps>

Full source: [cookbook/91\_tools/google/drive/file\_search.py](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/google/drive/file_search.py)