# Google Drive MCP

> Google Drive MCP lets your AI agent manage all your cloud files directly. Search documents by topic, not folder name; audit who has access to sensitive data, and convert Sheets or Docs into PDFs with a simple chat command. It acts like an expert librarian for your entire Google Drive.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** file-search, cloud-sync, document-sharing, file-permissions, version-control

## Description

Connect this MCP to your favorite agent—Claude, Cursor, or any compatible client—and completely change how you handle cloud storage. You stop digging through endless folder hierarchies. Instead, you talk to your AI agent and tell it what you need. It handles everything: finding that one PDF from last week, creating a new project folder, or checking if the marketing team actually has permission to view the Q4 budget.

It gives you granular control over sharing permissions, letting you audit who sees sensitive files instantly. You can also ask your agent to export specific documents, like converting a Google Sheet into a CSV file for accounting. This capability is hosted on Vinkius, making it one of the most complete ways to manage cloud content in a single place.

## Tools

### copy_file
Creates an exact duplicate of any existing file in Google Drive.

### update_file
Changes the metadata or actual content within a specified file.

### create_file_comment
Adds a specific comment to help collaborate on a document.

### list_file_comments
Retrieves all comments left by team members on a file.

### create_file
Initializes a brand new file or empty folder structure.

### create_permission
Grants access to a specific file for another email address or group.

### delete_file
Moves the selected file into the trash bin for later recovery.

### empty_trash
Permanently removes all files currently residing in your Drive's trash.

### export_file
Converts a Google Doc or Sheet into a specific file type, like PDF or CSV.

### get_drive_about
Provides usage metrics for your Drive account, such as quota limits and current storage used.

### get_file_metadata
Pulls detailed information about a specific file, including its owner or creation date.

### list_files
Generates a list of files and folders that exist in the specified directory path.

### list_permissions
Checks every user or group who currently has access to a given file.

### list_revisions
Displays the complete revision history of a file, showing when changes were made.

### search_files
Uses advanced Google Drive query syntax to search for files based on specific criteria like MIME type or name.

## Prompt Examples

**Prompt:** 
```
Find all spreadsheets I created in the last 30 days.
```

**Response:** 
```
Searching files... I found 4 spreadsheets created last month: 'Budget_Q2.xlsx', 'User_Feedback_Raw', 'Inventory_April', and 'Campaign_Results'. Would you like the metadata for any of these?
```

**Prompt:** 
```
Who has access to the file 'Confidential_Roadmap'?
```

**Response:** 
```
Checking permissions... The file 'Confidential_Roadmap' is shared with 3 people: Marcus R. (Owner), Sarah P. (Editor), and Mike T. (Viewer). It is NOT shared publicly.
```

**Prompt:** 
```
Create a new folder named 'Project Apollo Assets'.
```

**Response:** 
```
Creating folder... Success! I've created the folder 'Project Apollo Assets' in your root directory. The folder ID is FOLDER-93021.
```

## Capabilities

### Search and find files
You can ask your agent to locate documents across your entire Drive using natural language queries.

### Manage file structure
Create, delete, copy, or update folders and files right through the chat interface.

### Audit sharing permissions
Check exactly who has access to any file and quickly add or remove permissions for specific users or groups.

### Convert and export content
Export Google Docs, Sheets, and Slides into other formats like PDF or CSV using simple commands.

### Track document history
View a file's revision history to track every change made and see how the document evolved over time.

## Use Cases

### Auditing a client's access to sensitive documents
A project manager needs to confirm that only the legal team has viewing rights for 'ClientX Agreement'. Instead of manually checking permissions on 50 files, they simply ask their agent to run list_permissions and get an instant report.

### Preparing a quarterly board presentation
A content strategist needs the raw sales data from Q3 (a Google Sheet) exported as a CSV file for accounting. They use export_file, specifying both the source document and the required format in one prompt.

### Onboarding a new team member to a large project
A team lead needs to set up a central folder structure named 'Project Phoenix Assets'. They use create_file multiple times, building out the necessary nested folders and then using create_permission to grant access only to the new hires.

### Investigating why an old report disappeared
A user remembers a document from six months ago. They use search_files with specific query syntax, narrowing results by name and date range until they locate the exact file metadata needed.

## Benefits

- Finding misplaced documents is instant. Use natural language search to locate files based on content or date, instead of guessing folder names.
- You maintain control over who sees what. Quickly check permissions using list_permissions or grant access with create_permission, making compliance easier.
- Never lose a version again. The list_revisions tool lets you see the full history of any document to track changes and revert if needed.
- Simplify data handling. Export files directly—use export_file to turn Google Slides into PDFs or Sheets into CSVs for other programs.
- Keep your workspace tidy. You can create new folders using create_file, update file content with update_file, and delete old assets safely.

## How It Works

The bottom line is that your agent handles the complexity of Google Drive in plain conversation.

1. First, subscribe to this MCP using your Google OAuth Client ID and Secret.
2. Next, complete the secure authorization flow so your agent can access your Drive data.
3. Finally, start telling your AI client what you need done—like 'Find all PDFs from last month' or 'Share this file with Bob'.

## Frequently Asked Questions

**How do I search files using Google Drive MCP?**
You use natural language queries, which are run by the search_files tool. You don't need to know the exact folder path; just tell your agent what you're looking for.

**Can I export a Google Doc using Google Drive MCP?**
Yes, the export_file tool lets you convert Docs or Sheets into formats like PDF or CSV. You specify both the source file and the target format in your prompt.

**Does this MCP help me organize my folders?**
Absolutely. By using create_file, you can build out new folder structures instantly through chat commands, which is much faster than manual navigation.

**What if I need to see old versions of a file?**
You use the list_revisions tool. It retrieves the full revision history of any document, letting you track who changed what and when.

**Can Google Drive MCP share files with new people?**
Yes. You tell your agent to run create_permission, specifying the file and the email address for access control.