Google Drive MCP
In one line: Connect Google Drive so your UnleashX agent can search files, create and move them, manage folders and shared drives, and control sharing.
| Category | Storage |
| Authentication | OAuth (Google sign-in) |
| Setup time | ~2 minutes |
| Difficulty | Easy |
| Best for | Organizing files, automating uploads/downloads, and managing sharing across teams |
1. Overview
Google Drive is Google’s cloud file storage, holding documents, spreadsheets, forms, folders, and shared drives. Once connected, your UnleashX agent can search for files and folders, create files from text, copy/move/update files, upload and download, manage folders and shared drives, and set sharing permissions for people and teams. It can also watch for newly added files or spreadsheets. Connecting Google Drive to UnleashX makes file management hands-free: ask “find last month’s invoices and share the folder with finance” or “upload this report to the Q3 folder,” and the agent locates, organizes, and shares the right files for you.2. What you’ll need
A Google account with Drive
Any personal Google account or a Google Workspace account with Drive enabled.
Permission to grant access
You must be able to complete the Google sign-in and approve the requested permissions. Shared-drive actions may require team-membership rights.
No admin access? On a managed Google Workspace account, your admin may need to allow UnleashX, and some shared-drive operations may be restricted by your role.
3. Get your credentials
Google Drive uses Google OAuth 2.0. You do not create or paste an API key. UnleashX redirects you to Google, you sign in once, and Google issues an access token to UnleashX automatically.Start the connection in UnleashX
In your agent’s Data Connectors, find Google Drive and click Connect (see Section 4).
There is no key to copy. Access is granted by your Google sign-in and can be revoked anytime at your Google Account permissions page.
| Scope | Why UnleashX needs it |
|---|---|
https://www.googleapis.com/auth/drive | Full access to find, create, update, move, delete, and share files and folders. |
https://www.googleapis.com/auth/drive.file | Create and manage files the integration touches. |
https://www.googleapis.com/auth/userinfo.email | Identify which account is connected. |
4. Connect on UnleashX
Open your agent
Sign in at https://www.tryunleashx.com and open your agent.
5. Available tools
| Tool | What it does | Changes data? |
|---|---|---|
| Get File | Get a file’s metadata by ID. | No |
| Find Spreadsheets | Find spreadsheets (optionally in a folder). | No |
| Find Forms | Find Google Forms (optionally in a folder). | No |
| Find Folder | Find a folder by name/parent. | No |
| Find File | Find a file by query/folder. | No |
| Find File with Changes | Find files and report changes since last run. | No |
| List Drive Folders | List folders in Drive. | No |
| List Drive Folders with Changes | List folders and report changes since last run. | No |
| On New File | Trigger: return files added since last run. | No |
| On New Spreadsheet | Trigger: return spreadsheets added since last run. | No |
| Copy File | Copy a file (optional new name/folder). | ✏️ Yes |
| Create File from Text | Create a file from text content. | ✏️ Yes |
| Delete File | Delete a file. | ⚠️ Yes |
| Download File | Download a file. | No |
| Move File | Move a file to another folder. | ✏️ Yes |
| Share File | Share a file with people at a permission level. | ✏️ Yes |
| Update File | Update a file’s content or name. | ✏️ Yes |
| Search Files | Search files by term, type, location, date. | No |
| Create Folder | Create a folder. | ✏️ Yes |
| Delete Folder | Delete a folder. | ⚠️ Yes |
| Share Folder | Share a folder with people at a permission level. | ✏️ Yes |
| Create Shared Drive | Create a shared (team) drive. | ✏️ Yes |
| Delete Shared Drive | Delete a shared drive. | ⚠️ Yes |
| Get Shared Drive | Get details of one shared drive. | No |
| Get Many Shared Drives | List multiple shared drives. | No |
| Update Shared Drive | Update a shared drive’s name/settings/theme. | ✏️ Yes |
| Upload File | Upload a file to Drive. | ✏️ Yes |
6. Example usage
“Find the ‘Q3 Reports’ folder and share it with finance@acme.com as a commenter.” Runs Find Folder, then Share Folder.
“Create a text file called ‘meeting-notes’ with today’s notes in my Projects folder.” Runs Find Folder to locate the folder, then Create File from Text.
7. Permissions & data access
UnleashX can:- Search, read, and download files and folders.
- Create, copy, move, update, and upload files.
- Create and manage folders and shared drives.
- Set sharing permissions for files and folders.
- Access Gmail, Calendar, or other Google services unless connected separately.
- Change your Google account settings or password.
- Bypass shared-drive role restrictions enforced by your organization.
access-token header, a google_drive_access_token header, or an Authorization: Bearer header, falling back to your UnleashX session), refreshed automatically when it expires.
8. Troubleshooting
| Problem | What it means | How to fix it |
|---|---|---|
401 Unauthorized | The access token is missing or expired. | Reconnect Google Drive in Data Connectors. |
403 Forbidden | Missing scope, or you lack rights on the file/shared drive. | Re-authorize all scopes; confirm your role allows the action. |
404 Not Found | The file/folder ID doesn’t exist or isn’t shared with you. | Verify the ID and your access. |
| Delete blocked | A delete tool requires confirmation. | Re-issue with confirm_deletion set to true. |