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

# Google Drive

> Browse, upload, and manage files in Google Drive

Connect your Google account to let selected agents browse, search, upload, and manage the Drive files you approve.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="File management" icon="folder-open">
    Browse, upload, download, and organize files and folders directly from chat or through an agent.
  </Card>

  <Card title="Sharing and permissions" icon="share-nodes">
    Create and manage sharing permissions, generate shareable links, and control access to files and folders.
  </Card>

  <Card title="Search and discovery" icon="magnifying-glass">
    Find files by name, content, or type within the Drive access granted to the connected account.
  </Card>

  <Card title="15+ agent tools" icon="wrench">
    Give your AI agent full read/write access to files, folders, permissions, comments, and shared drives.
  </Card>
</CardGroup>

***

## Connect Google Drive

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Google Drive**.
  </Step>

  <Step title="Authorize with Google">
    Click **Connect** — you'll be redirected to Google's OAuth consent screen. Sign in with your Google account and
    grant Drive access.
  </Step>

  <Step title="Start using Google Drive in agents">
    Open the agent and enable only the Google Drive actions it needs. Access is limited by the connected Google account.
  </Step>
</Steps>

***

## Agent tools

Add Google Drive tools to agents that need them. Their access is limited by the connected Google account and selected
tools.

### Files

| Tool              | Description                                      |
| ----------------- | ------------------------------------------------ |
| Find file         | Search for files by name, type, or content       |
| Get file metadata | Retrieve metadata and details of a specific file |
| Create file       | Create a new file or folder in Drive             |
| Upload file       | Upload a file to Drive from content or URL       |
| Download file     | Download a file's content by ID                  |
| Edit file         | Update a file's content                          |
| Move file         | Move a file to a different folder                |
| Copy file         | Create a copy of an existing file                |
| Trash file        | Move a file to the trash                         |

### Folders

| Tool          | Description                         |
| ------------- | ----------------------------------- |
| Create folder | Create a new folder in Drive        |
| Find folder   | Search for a folder by name or path |

### Permissions

| Tool              | Description                                          |
| ----------------- | ---------------------------------------------------- |
| Create permission | Share a file or folder with a user, group, or domain |
| List permissions  | List all sharing permissions on a file               |
| Update permission | Change the role of an existing permission            |
| Delete permission | Remove a sharing permission from a file              |

***

## Triggers

<Note>
  Triggers are not yet available for Google Drive. Tools are fully supported — connect and start using them in any
  agent.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Find and summarize a document">
    Ask your agent to search Drive for a specific report, read its contents, and provide a summary in chat — complete
    with a direct link to the original file.
  </Accordion>

  <Accordion title="Organize files into project folders">
    Ask your agent to create a folder structure for a new project and move relevant files from your Drive into the
    correct subfolders — all from a single conversation.
  </Accordion>

  <Accordion title="Share files with your team">
    Tell your agent to find a document and share it with specific team members or generate a shareable link with the
    right permission level — no need to open Drive.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth consent screen doesn't appear">
    Make sure pop-ups are not blocked in your browser. If the Google sign-in page doesn't open, try again with pop-ups
    allowed or use a different browser.
  </Accordion>

  <Accordion title="Agent can't find my files">
    The agent searches across files accessible to the authenticated Google account. Files in shared drives may require
    additional permissions — make sure the file is shared with your account.
  </Accordion>

  <Accordion title="Upload fails with a permission error">
    Check that you have write access to the target folder. If uploading to a shared drive, confirm that your account has
    contributor or manager permissions.
  </Accordion>

  <Accordion title="Authorization expired">
    Google OAuth tokens can expire. Go to **Settings → Integrations → Google Drive**, disconnect, and reconnect to
    refresh your authorization.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>