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

# Google Drive Integration

> Connect ZeroTwo to Google Drive to access, search, and manage your files with AI assistance

The Google Drive integration allows ZeroTwo to interact with your Google Drive files, enabling you to search documents, retrieve file contents, and manage your Drive files directly through natural language commands.

## What you can do

With Google Drive connected to ZeroTwo, you can:

<CardGroup cols={2}>
  <Card title="Search files" icon="magnifying-glass">
    Find files and folders using natural language queries across your entire Drive
  </Card>

  <Card title="Read documents" icon="file-lines">
    Access and analyze content from Google Docs, Sheets, Slides, and PDFs
  </Card>

  <Card title="Upload files" icon="cloud-arrow-up">
    Create new files or upload content directly to your Drive
  </Card>

  <Card title="Manage files" icon="folder-tree">
    Organize, rename, move, and share files through AI commands
  </Card>
</CardGroup>

## Connecting Google Drive

<Steps>
  <Step title="Open integrations">
    Navigate to Settings → Integrations in ZeroTwo, or click the integrations icon in the sidebar.
  </Step>

  <Step title="Find Google Drive">
    Locate the Google Drive integration in the list of available connectors.
  </Step>

  <Step title="Authorize access">
    Click "Connect" and you'll be redirected to Google's authorization page.

    **Permissions requested:**

    * View and download files from your Google Drive
    * Create, edit, and delete files in your Google Drive
    * View and manage Drive folders
    * See file metadata (names, dates, sharing)
  </Step>

  <Step title="Confirm connection">
    <Check>
      After authorization, you'll be redirected back to ZeroTwo. Google Drive will now appear as connected in your integrations list.
    </Check>
  </Step>
</Steps>

<Info>
  ZeroTwo uses OAuth 2.0 for secure authentication. Your Google credentials are never stored on ZeroTwo servers—only an access token that you can revoke at any time.
</Info>

## Using Google Drive with AI

Once connected, interact with Google Drive through natural language:

### Searching for files

<CodeGroup>
  ```text Simple search theme={null}
  "Find my presentation about Q4 goals"
  "Show me spreadsheets from last month"
  "Search for PDFs containing 'budget'"
  ```

  ```text Advanced search theme={null}
  "Find all documents shared with john@company.com"
  "Show me files in the 'Projects' folder modified this week"
  "List all spreadsheets larger than 5MB"
  ```

  ```text Specific queries theme={null}
  "Find the most recent version of the marketing plan"
  "Show me all Google Docs I created in January"
  "Search for files with 'contract' in the name"
  ```
</CodeGroup>

### Reading and analyzing files

<Tabs>
  <Tab title="Documents">
    ```text theme={null}
    "Summarize the content of 'Project Proposal.docx'"
    "Read the Q3 Report and extract key metrics"
    "What are the action items from the meeting notes?"
    ```

    The AI will retrieve and analyze the document content.
  </Tab>

  <Tab title="Spreadsheets">
    ```text theme={null}
    "Show me the data from Sheet1 in the Sales spreadsheet"
    "Calculate the total revenue from the Q4 Budget sheet"
    "Find the highest value in the 'Revenue' column"
    ```

    The AI can read and perform calculations on spreadsheet data.
  </Tab>

  <Tab title="Presentations">
    ```text theme={null}
    "Summarize the main points from the pitch deck"
    "Extract the speaker notes from slide 5"
    "List all slides with charts or graphs"
    ```

    The AI analyzes slide content and speaker notes.
  </Tab>
</Tabs>

### Creating and uploading files

<Steps>
  <Step title="Create new documents">
    ```text theme={null}
    "Create a new Google Doc called 'Meeting Notes' with today's date"
    "Make a spreadsheet to track project expenses"
    "Create a presentation outline for the product launch"
    ```
  </Step>

  <Step title="Upload content">
    ```text theme={null}
    "Upload this text as a new Google Doc in the 'Drafts' folder"
    "Save this data as a spreadsheet named 'Customer List'"
    "Create a document with this content and share it with the team"
    ```
  </Step>

  <Step title="Specify location">
    ```text theme={null}
    "Create a new folder called '2024 Projects'"
    "Save this file in the 'Documents/Work' folder"
    "Upload to the shared 'Team Resources' folder"
    ```
  </Step>
</Steps>

### Managing files

<AccordionGroup>
  <Accordion title="Organizing">
    ```text theme={null}
    "Move the Q3 Report to the 'Archives' folder"
    "Rename 'Draft_v3.docx' to 'Final Proposal.docx'"
    "Create a folder structure for the new project"
    ```
  </Accordion>

  <Accordion title="Sharing">
    ```text theme={null}
    "Share the Budget spreadsheet with alice@company.com"
    "Make the project plan viewable by anyone with the link"
    "Give edit access to the Marketing folder to bob@company.com"
    ```
  </Accordion>

  <Accordion title="Information">
    ```text theme={null}
    "When was the contract last modified?"
    "Who has access to the financial projections?"
    "Show me the sharing settings for this document"
    ```
  </Accordion>
</AccordionGroup>

## Supported file types

The Google Drive integration supports various file formats:

<Tabs>
  <Tab title="Google Workspace">
    **Native Google formats:**

    * Google Docs (.gdoc)
    * Google Sheets (.gsheet)
    * Google Slides (.gslides)
    * Google Forms (.gform)
    * Google Drawings (.gdraw)

    These provide the best integration experience with full content access.
  </Tab>

  <Tab title="Microsoft Office">
    **Office formats:**

    * Word documents (.docx, .doc)
    * Excel spreadsheets (.xlsx, .xls)
    * PowerPoint presentations (.pptx, .ppt)

    Content can be read and analyzed.
  </Tab>

  <Tab title="Documents">
    **Text and document formats:**

    * PDF files (.pdf)
    * Plain text files (.txt)
    * Rich text files (.rtf)
    * Markdown files (.md)

    Full text extraction and analysis supported.
  </Tab>

  <Tab title="Other formats">
    **Additional supported types:**

    * CSV files (.csv)
    * JSON files (.json)
    * Code files (.js, .py, .java, etc.)
    * Images (for metadata and descriptions)

    Some formats have limited content extraction.
  </Tab>
</Tabs>

<Warning>
  **File size limits:**

  * Individual files up to 100MB can be processed
  * Very large files may take longer to process
  * Complex spreadsheets with many sheets may have partial extraction
</Warning>

## Advanced features

### Filtering and sorting

```text theme={null}
"Find spreadsheets modified in the last 7 days, sorted by size"
"Show me all PDFs in the 'Contracts' folder, newest first"
"List documents I own that are shared externally"
```

### Batch operations

```text theme={null}
"Move all files from 'Old Project' folder to 'Archive'"
"Share all documents in the 'Team Resources' folder with the team"
"Rename all files with 'draft' to include today's date"
```

### Content analysis

```text theme={null}
"Compare the data between Q3 and Q4 budget spreadsheets"
"Extract all email addresses mentioned in this document"
"Find documents that mention 'machine learning' or 'AI'"
```

### Folder navigation

```text theme={null}
"List all files in the 'Projects/2024/Q1' folder"
"Show me the folder structure under 'Department Files'"
"Find all folders shared with external users"
```

## Privacy and permissions

### What ZeroTwo can access

<Info>
  **Access scope:**

  * Only files and folders in your Google Drive
  * Only when you explicitly request Drive operations
  * File metadata (names, dates, sizes, permissions)
  * File contents when you ask to read or analyze them

  **What ZeroTwo cannot access:**

  * Files you haven't explicitly queried
  * Other Google services (Gmail, Calendar) without separate authorization
  * Files in Team Drives unless you have access
  * Deleted files in trash (unless specifically requested)
</Info>

### Permission levels

The Google Drive integration requests these permissions:

<ResponseField name="drive.readonly" type="scope">
  View and download all your Google Drive files
</ResponseField>

<ResponseField name="drive.file" type="scope">
  View and manage files created or opened by ZeroTwo
</ResponseField>

<ResponseField name="drive" type="scope">
  Full access to create, edit, delete, and share files (optional, for full functionality)
</ResponseField>

<Tip>
  You can grant limited permissions initially and expand access later if needed for additional features.
</Tip>

### Data handling

<Check>
  **Privacy protections:**

  * File contents are processed only for your queries
  * No Drive content stored permanently on ZeroTwo servers
  * File data not used for AI model training
  * Access tokens encrypted and securely stored
  * You can revoke access anytime through Google account settings
</Check>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection issues">
    **Problem**: Can't connect or authorization fails

    **Solutions:**

    1. Ensure you're logged into the correct Google account
    2. Check that third-party app access is enabled in Google settings
    3. Try disconnecting and reconnecting the integration
    4. Clear browser cache and cookies
    5. Disable browser extensions that might block OAuth

    If issues persist, check your Google account's [security settings](https://myaccount.google.com/security).
  </Accordion>

  <Accordion title="Can't find files">
    **Problem**: AI can't locate specific files

    **Solutions:**

    1. Verify the file exists and you have access
    2. Check file isn't in trash or a Team Drive without access
    3. Try more specific search terms (include file extension)
    4. Specify the folder path if you know it
    5. Check file sharing permissions

    ```text theme={null}
    Instead of: "Find the report"
    Try: "Find the file named 'Q4-Report.docx' in the 'Reports' folder"
    ```
  </Accordion>

  <Accordion title="Permission errors">
    **Problem**: "Permission denied" or "Access restricted" errors

    **Solutions:**

    1. Check the file's sharing settings in Google Drive
    2. Verify you own the file or have edit permissions
    3. For Team Drive files, ensure you have appropriate access
    4. Try reconnecting the integration with full permissions
    5. Contact the file owner to request access

    Some operations (like editing or deleting) require owner or editor permissions.
  </Accordion>

  <Accordion title="Large file issues">
    **Problem**: Timeout or errors with large files

    **Solutions:**

    1. For very large files (>50MB), process sections instead of entire file
    2. Break complex operations into smaller steps
    3. For spreadsheets, specify specific sheets or ranges
    4. Consider downloading large files and uploading to ZeroTwo directly

    ```text theme={null}
    Instead of: "Analyze the entire 100MB spreadsheet"
    Try: "Analyze Sheet1 from the sales data spreadsheet"
    ```
  </Accordion>

  <Accordion title="Sync delays">
    **Problem**: Recent changes not reflected immediately

    **Solutions:**

    1. Recent file changes may take a few minutes to sync
    2. Try refreshing: "Refresh my Drive file list"
    3. Specify file by ID if you have it (more reliable than name)
    4. Wait 1-2 minutes after making changes in Google Drive

    Google Drive API may have brief caching delays.
  </Accordion>
</AccordionGroup>

## Disconnecting Google Drive

<Steps>
  <Step title="Navigate to integrations">
    Settings → Integrations → Google Drive
  </Step>

  <Step title="Click disconnect">
    Select "Disconnect" or "Revoke Access"
  </Step>

  <Step title="Confirm">
    <Warning>
      Disconnecting will prevent ZeroTwo from accessing your Drive files. You can reconnect anytime.
    </Warning>

    Confirm the disconnection.
  </Step>

  <Step title="Revoke from Google (optional)">
    For complete removal, also revoke access in [Google account settings](https://myaccount.google.com/permissions).
  </Step>
</Steps>

## Use cases and examples

### Document research

```text theme={null}
"Search my Drive for all documents mentioning 'project alpha' and summarize their key points"
```

### Data analysis

```text theme={null}
"Read the sales data from Q1-Sales.xlsx and calculate the average order value"
```

### Content creation

```text theme={null}
"Create a new Google Doc with an outline for a blog post about AI productivity tools"
```

### File organization

```text theme={null}
"Find all PDFs from 2023 and move them to the '2023 Archive' folder"
```

### Collaboration

```text theme={null}
"Share the project roadmap document with the team and give them edit access"
```

## Related integrations

<CardGroup cols={3}>
  <Card title="Gmail" icon="envelope" href="/integrations/gmail">
    Email integration
  </Card>

  <Card title="Google Calendar" icon="calendar" href="/integrations/google-calendar">
    Calendar integration
  </Card>

  <Card title="Google Contacts" icon="address-book" href="/integrations/google-contacts">
    Contacts integration
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="MCP overview" icon="plug" href="/integrations/mcp-overview">
    Learn about Model Context Protocol integrations
  </Card>

  <Card title="Custom extensions" icon="puzzle-piece" href="/tools/custom-extensions">
    Build custom integrations with MCP
  </Card>

  <Card title="Tool permissions" icon="shield" href="/tools/permissions-and-privacy">
    Understand integration permissions
  </Card>

  <Card title="All integrations" icon="grid" href="/integrations">
    Browse all available integrations
  </Card>
</CardGroup>