# Google Drive

```json
{
  "name": "Google Drive",
  "slug": "googledrive",
  "url": "https://composio.dev/toolkits/googledrive",
  "markdown_url": "https://composio.dev/toolkits/googledrive.md",
  "logo_url": "https://logos.composio.dev/api/googledrive",
  "categories": [
    "document & file management"
  ],
  "is_composio_managed": true,
  "updated_at": "2026-05-06T08:14:20.203Z"
}
```

![Google Drive logo](https://logos.composio.dev/api/googledrive)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Google Drive MCP or direct API to search files, upload documents, share folders, and manage permissions through natural language.

## Summary

Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices.

## Categories

- document & file management

## Toolkit Details

- Tools: 50
- Triggers: 7
- Managed auth: Managed by Composio

## Images

- Logo: https://logos.composio.dev/api/googledrive

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Google Drive.
  - Setup:
    - Configure Oauth2 credentials for Google Drive.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Create a new folder named 'Invoices'
- Share last uploaded file with my team
- Add comment to project proposal document
- Copy template file to today's reports folder

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE` | Add file sharing preference | Modifies sharing permissions for an existing google drive file, granting a specified role to a user, group, domain, or 'anyone'. |
| `GOOGLEDRIVE_COPY_FILE` | Copy file | Duplicates an existing file in google drive, identified by its `file id`. |
| `GOOGLEDRIVE_CREATE_COMMENT` | Create Comment | Tool to create a comment on a file. use when you need to add a new comment to a specific file in google drive. |
| `GOOGLEDRIVE_CREATE_DRIVE` | Create Shared Drive | Tool to create a new shared drive. use when you need to programmatically create a new shared drive for collaboration or storage. |
| `GOOGLEDRIVE_CREATE_FILE` | Create File or Folder | Creates a new file or folder with metadata. use to create empty files or folders, or files with content by providing it in the request body (though this action primarily focuses on metadata creation). |
| `GOOGLEDRIVE_CREATE_FILE_FROM_TEXT` | Create a File from Text | Creates a new file in google drive from provided text content (up to 10mb), supporting various formats including automatic conversion to google workspace types. |
| `GOOGLEDRIVE_CREATE_FOLDER` | Create a folder | Creates a new folder in google drive, optionally within a parent folder specified by its id or name; if a parent name is provided but not found, the action will fail. |
| `GOOGLEDRIVE_CREATE_REPLY` | Create Reply | Tool to create a reply to a comment in google drive. use when you need to respond to an existing comment on a file. |
| `GOOGLEDRIVE_CREATE_SHORTCUT_TO_FILE` | Create Shortcut to File/Folder | Tool to create a shortcut to a file or folder in google drive. use when you need to link to an existing drive item from another location without duplicating it. |
| `GOOGLEDRIVE_DELETE_COMMENT` | Delete Comment | Deletes a comment from a file. use when you need to remove a specific comment from a google drive file. |
| `GOOGLEDRIVE_DELETE_DRIVE` | Delete Shared Drive | Tool to permanently delete a shared drive. use when you need to remove a shared drive and its contents (if specified). |
| `GOOGLEDRIVE_DELETE_PERMISSION` | Delete Permission | Deletes a permission from a file by permission id. use when you need to revoke access for a specific user or group from a file. |
| `GOOGLEDRIVE_DELETE_REPLY` | Delete Reply | Tool to delete a specific reply by reply id. use when you need to remove a reply from a comment on a file. |
| `GOOGLEDRIVE_DOWNLOAD_FILE` | Download a file from Google Drive | Downloads a file from google drive by its id. for google workspace documents (docs, sheets, slides), optionally exports to a specified `mime type`. for other file types, downloads in their native format regardless of mime type. |
| `GOOGLEDRIVE_EDIT_FILE` | Edit File | Updates an existing google drive file by overwriting its entire content with new text (max 10mb). |
| `GOOGLEDRIVE_EMPTY_TRASH` | Empty Trash | Tool to permanently delete all of the user's trashed files. use when you want to empty the trash in google drive. |
| `GOOGLEDRIVE_FILES_MODIFY_LABELS` | Modify File Labels | Modifies the set of labels applied to a file. returns a list of the labels that were added or modified. use when you need to programmatically change labels on a google drive file, such as adding, updating, or removing them. |
| `GOOGLEDRIVE_FIND_FILE` | Find file | Tool to list or search for files and folders in google drive. use when you need to find specific files based on query criteria or list contents of a drive/folder. |
| `GOOGLEDRIVE_FIND_FOLDER` | Find folder | Tool to find a folder in google drive by its name and optionally a parent folder. use when you need to locate a specific folder to perform further actions like creating files in it or listing its contents. |
| `GOOGLEDRIVE_GENERATE_IDS` | Generate File IDs | Generates a set of file ids which can be provided in create or copy requests. use when you need to pre-allocate ids for new files or copies. |
| `GOOGLEDRIVE_GET_ABOUT` | Get about | Tool to retrieve information about the user, the user's drive, and system capabilities. use when you need to check storage quotas, user details, or supported import/export formats. |
| `GOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKEN` | Get Changes Start Page Token | Tool to get the starting pagetoken for listing future changes in google drive. use this when you need to track changes to files and folders. |
| `GOOGLEDRIVE_GET_COMMENT` | Get Comment | Tool to get a comment by id. use when you need to retrieve a specific comment from a google drive file and have both the file id and comment id. |
| `GOOGLEDRIVE_GET_DRIVE` | Get Shared Drive | Tool to get a shared drive by id. use when you need to retrieve information about a specific shared drive. |
| `GOOGLEDRIVE_GET_FILE_METADATA` | Get File Metadata | Tool to get a file's metadata by id. use when you need to retrieve the metadata for a specific file in google drive. |
| `GOOGLEDRIVE_GET_PERMISSION` | Get Permission | Gets a permission by id. use this tool to retrieve a specific permission for a file or shared drive. |
| `GOOGLEDRIVE_GET_REPLY` | Get Reply | Tool to get a specific reply to a comment on a file. use when you need to retrieve the details of a particular reply. |
| `GOOGLEDRIVE_GET_REVISION` | Get Revision | Tool to get a specific revision's metadata by revision id. use when you need to retrieve information about a particular version of a file. |
| `GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION` | Delete folder or file | Tool to delete a file or folder in google drive. use when you need to permanently remove a specific file or folder using its id. note: this action is irreversible. |
| `GOOGLEDRIVE_HIDE_DRIVE` | Hide Shared Drive | Tool to hide a shared drive from the default view. use when you want to remove a shared drive from the user's main google drive interface without deleting it. |
| `GOOGLEDRIVE_LIST_CHANGES` | List Changes | Tool to list the changes for a user or shared drive. use when you need to track modifications to files and folders, such as creations, deletions, or permission changes. this action requires a `pagetoken` which can be initially obtained using the `get changes start page token` action or from a previous `list changes` response. |
| `GOOGLEDRIVE_LIST_COMMENTS` | List Comments | Tool to list all comments for a file in google drive. use when you need to retrieve comments associated with a specific file. |
| `GOOGLEDRIVE_LIST_FILE_LABELS` | List File Labels | Tool to list the labels on a file. use when you need to retrieve all labels associated with a specific file in google drive. |
| `GOOGLEDRIVE_LIST_FILES` | List Files and Folders | Tool to list a user's files and folders in google drive. use this to search or browse for files and folders based on various criteria. |
| `GOOGLEDRIVE_LIST_PERMISSIONS` | List Permissions | Tool to list a file's permissions. use when you need to retrieve all permissions associated with a specific file or shared drive. |
| `GOOGLEDRIVE_LIST_REPLIES_TO_COMMENT` | List Replies to Comment | Tool to list replies to a comment in google drive. use this when you need to retrieve all replies associated with a specific comment on a file. |
| `GOOGLEDRIVE_LIST_REVISIONS` | List File Revisions | Tool to list a file's revisions. use when you need to retrieve the revision history of a specific file in google drive. |
| `GOOGLEDRIVE_LIST_SHARED_DRIVES` | List Shared Drives | Tool to list the user's shared drives. use when you need to get a list of all shared drives accessible to the authenticated user. |
| `GOOGLEDRIVE_MOVE_FILE` | Move File | Tool to move a file from one folder to another in google drive. use when you need to reorganize files by changing their parent folder(s). |
| `GOOGLEDRIVE_STOP_WATCH_CHANNEL` | Stop Watch Channel | Tool to stop watching resources through a specified channel. use this when you want to stop receiving notifications for a previously established watch. |
| `GOOGLEDRIVE_UNHIDE_DRIVE` | Unhide Shared Drive | Tool to unhide a shared drive. use when you need to restore a shared drive to the default view. |
| `GOOGLEDRIVE_UNTRASH_FILE` | Untrash File | Tool to restore a file from the trash. use when you need to recover a deleted file. this action updates the file's metadata to set the 'trashed' property to false. |
| `GOOGLEDRIVE_UPDATE_COMMENT` | Update Comment | Tool to update an existing comment on a google drive file. use when you need to change the content or status (e.g., resolve) of a comment. |
| `GOOGLEDRIVE_UPDATE_DRIVE` | Update Shared Drive | Tool to update the metadata for a shared drive. use when you need to modify properties like the name, theme, background image, or restrictions of a shared drive. |
| `GOOGLEDRIVE_UPDATE_FILE_PUT` | Update File (Metadata) | Updates file metadata. uses patch semantics (partial update) as per google drive api v3. use this tool to modify attributes of an existing file like its name, description, or parent folders. note: this action currently supports metadata updates only. file content updates require multipart/related upload and are not yet implemented. |
| `GOOGLEDRIVE_UPDATE_FILE_REVISION_METADATA` | Update File Revision Metadata | Updates metadata of a file revision (e.g., keepforever, publish). use this tool to modify the metadata of a specific revision of a file in google drive. |
| `GOOGLEDRIVE_UPDATE_PERMISSION` | Update Permission | Tool to update a permission with patch semantics. use when you need to modify an existing permission for a file or shared drive. |
| `GOOGLEDRIVE_UPDATE_REPLY` | Update Reply | Tool to update a reply to a comment on a google drive file. use when you need to modify the content of an existing reply. |
| `GOOGLEDRIVE_UPLOAD_FILE` | Upload File | Uploads a file (max 5mb) to google drive, moving it to a specified folder if a valid folder id is provided, otherwise uploads to root. |
| `GOOGLEDRIVE_WATCH_CHANGES` | Watch Drive Changes | Tool to subscribe to changes for a user or shared drive in google drive. use when you need to monitor a google drive for modifications and receive notifications at a specified webhook url. |

## Supported Triggers

| Trigger slug | Name | Description |
|---|---|---|
| `GOOGLEDRIVE_COMMENT_ADDED_TRIGGER` | Comment Added (Docs/Sheets/Slides) | Triggers when a new comment is added to Google Docs, Sheets, or Slides. |
| `GOOGLEDRIVE_FILE_CREATED_TRIGGER` | File Created | Triggers when a new file is created/added in Google Drive. This trigger monitors files and fires when new files are detected. |
| `GOOGLEDRIVE_FILE_DELETED_OR_TRASHED_TRIGGER` | File Deleted or Trashed | Triggers when a file is moved to trash or permanently deleted in Google Drive. |
| `GOOGLEDRIVE_FILE_SHARED_PERMISSIONS_ADDED` | File Shared (Permissions Added) | Triggers when new sharing permissions are granted to a file or folder in Google Drive. This trigger monitors the Drive Changes API to detect files that changed and, for those files, compares their current permissions against previously seen permissions to identify newly added sharing entries. |
| `GOOGLEDRIVE_FILE_UPDATED_TRIGGER` | File Updated | Triggers when a file's metadata or content changes in Google Drive. Emits file ID, modification timestamp, and editor info. |
| `GOOGLEDRIVE_GOOGLE_DRIVE_CHANGES` | Google Drive Changes | Triggers when changes are detected in a Google Drive. |
| `GOOGLEDRIVE_NEW_FILE_MATCHING_QUERY_TRIGGER` | New File Matching Query | Triggers when a new Google Drive file matches a provided query. |

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Googledrive Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Googledrive actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Create a folder named "Team Documents" in my Drive'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a folder named "Team Documents" in my Drive'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Googledrive tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a folder named Project Docs in my Google Drive')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Create a folder named Project Docs in my Google Drive' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Google Drive Integration

- Supports both Google Drive MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Google Drive data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Google Drive access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Google Drive
- Scoped, least privilege access to Google Drive resources
- Full audit trail of agent actions to support review and compliance

## Use Google Drive with any AI Agent Framework

Choose a framework you want to connect Google Drive with:

- [ChatGPT](https://composio.dev/toolkits/googledrive/framework/chatgpt)
- [OpenAI Agents SDK](https://composio.dev/toolkits/googledrive/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/googledrive/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/googledrive/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/googledrive/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/googledrive/framework/codex)
- [Cursor](https://composio.dev/toolkits/googledrive/framework/cursor)
- [VS Code](https://composio.dev/toolkits/googledrive/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/googledrive/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/googledrive/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/googledrive/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/googledrive/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/googledrive/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/googledrive/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/googledrive/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/googledrive/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/googledrive/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/googledrive/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/googledrive/framework/autogen)

## Related Toolkits

- [Google Docs](https://composio.dev/toolkits/googledocs) - Google Docs is a cloud-based word processor that enables document creation and real-time collaboration. Its seamless sharing and version history make team editing and content management a breeze.
- [Google Super](https://composio.dev/toolkits/googlesuper) - Google Super is an all-in-one suite combining Gmail, Drive, Calendar, Sheets, Analytics, and more. It gives you a unified platform to manage your digital life, boosting productivity and organization.
- [Affinda](https://composio.dev/toolkits/affinda) - Affinda is an AI-powered document processing platform that automates data extraction from resumes, invoices, and more. It streamlines document-heavy workflows by turning files into structured, actionable data.
- [Agility cms](https://composio.dev/toolkits/agility_cms) - Agility CMS is a headless content management system for building and managing digital experiences across platforms. It lets teams update content quickly and deliver omnichannel experiences with ease.
- [Algodocs](https://composio.dev/toolkits/algodocs) - Algodocs is an AI-powered platform that automates data extraction from business documents. It delivers fast, secure, and accurate processing without templates or manual training.
- [Api2pdf](https://composio.dev/toolkits/api2pdf) - Api2Pdf is a REST API for generating PDFs from HTML, URLs, and documents using powerful engines like wkhtmltopdf and Headless Chrome. It streamlines document conversion and automation for developers and businesses.
- [Aryn](https://composio.dev/toolkits/aryn) - Aryn is an AI-powered platform for parsing, extracting, and analyzing data from unstructured documents. Use it to automate document processing and unlock actionable insights from your files.
- [Boldsign](https://composio.dev/toolkits/boldsign) - Boldsign is a digital eSignature platform for sending, signing, and tracking documents online. Organizations use it to automate agreements and manage legally binding workflows efficiently.
- [Boloforms](https://composio.dev/toolkits/boloforms) - BoloForms is an eSignature platform built for small businesses, offering unlimited signatures, templates, and forms. It simplifies digital document signing and team collaboration at a predictable, fixed price.
- [Box](https://composio.dev/toolkits/box) - Box is a cloud content management and file sharing platform for businesses. It helps teams securely store, organize, and collaborate on files from anywhere.
- [Carbone](https://composio.dev/toolkits/carbone) - Carbone is a blazing-fast report generator that turns JSON data into PDFs, Word docs, spreadsheets, and more using flexible templates. It lets you automate document creation at scale with minimal code.
- [Castingwords](https://composio.dev/toolkits/castingwords) - CastingWords is a transcription service specializing in human-powered, accurate transcripts via a simple API. Get seamless audio-to-text conversion for interviews, meetings, podcasts, and more.
- [Cloudconvert](https://composio.dev/toolkits/cloudconvert) - CloudConvert is a powerful file conversion service supporting over 200 file formats. It streamlines converting, compressing, and managing documents, media, and more, all in one place.
- [Cloudlayer](https://composio.dev/toolkits/cloudlayer) - Cloudlayer is a document and asset generation service for creating PDFs and images via API or SDKs. It lets you automate high-quality doc creation, saving dev time and reducing manual work.
- [Cloudpress](https://composio.dev/toolkits/cloudpress) - Cloudpress is a content export tool for Google Docs and Notion. It automates publishing to your favorite Content Management Systems.
- [Contentful graphql](https://composio.dev/toolkits/contentful_graphql) - Contentful graphql is a content delivery API that lets you access Contentful data using GraphQL queries. It gives you efficient, flexible ways to fetch and manage structured content for any digital project.
- [Conversion tools](https://composio.dev/toolkits/conversion_tools) - Conversion Tools is an online service for converting documents between formats such as PDF, Word, Excel, XML, and CSV. It lets you automate complex document workflows with just a few clicks.
- [Convertapi](https://composio.dev/toolkits/convertapi) - ConvertAPI is a robust file conversion service for documents, images, and spreadsheets. It streamlines programmatic format changes and lets developers automate complex workflows with a single API.
- [Craftmypdf](https://composio.dev/toolkits/craftmypdf) - CraftMyPDF is a web-based service for designing and generating PDFs with templates and live data. It streamlines document creation by automating personalized PDFs at scale.
- [Docmosis](https://composio.dev/toolkits/docmosis) - Docmosis generates PDF and Word documents from user-defined templates. It's perfect for merging data fields to quickly produce reports, invoices, and business letters.

## Frequently Asked Questions

### Do I need my own developer credentials to use Googledrive with Composio?

No, you can get started immediately using Composio's built-in Googledrive app. For production, we recommend configuring your own OAuth credentials.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)