Google Drive

Name: Google Drive
Brand: Apoth3osis
SKU: 697bb62731d2bd755ac04037
Price: 0.05 USD
Availability: InStock

Function

Available ActionsEach successful request consumes credits as outlined below.

search_files^5crget_file_metadata^5crdownload_file_to_storage^5crupload_file_from_storage^5crcreate_folder^5crensure_folder_path^5crmove_file^5crcopy_file^5crtrash_file^5crdelete_file^5crshare_file^5crlist_permissions^5cr

Details

Give your AI agent access to Google Drive for seamless file management, organization, and collaboration. Search across your Drive to find files by name or content, download files to AgentPMT storage for processing, and upload new files back to Drive from AgentPMT storage or public URLs. Create folder structures with automatic path creation, move and copy files between folders, and manage sharing permissions to collaborate with others. Export Google Docs, Sheets, and Slides to formats like PDF, DOCX, or XLSX. This tool is essential for agents that need to work with documents stored in Drive, automate file organization, sync content between systems, or manage document workflows. All operations run securely through your connected Google OAuth account with support for both personal Drive and shared drives.

Workflows Using This Tool

2 / 3

Workflow

Saves ~30 min

Plaud Call Logger for Pipedrive

Turns your Plaud voice recordings of client calls into Pipedrive records automatically. Reviews every new recording, identifies genuine client conversations, transcribes them (reusing the recording's own transcript when one exists), saves the transcript to a "Plaud Call Logs" Drive folder, matches the spoken client name and company to a Pipedrive person and open deal, attaches a call note with the discussion summary, commitments, next steps, and transcript link, and creates a follow-up activity dated from spoken commitments. Keeps a Google Sheet ledger so every recording is processed exactly once; recordings that are not client calls are logged and skipped. Re-runnable and idempotent.

Use Cases

Search Drive files by name or content, Download files to AgentPMT storage for processing, Upload files to Drive from AgentPMT storage, Create folder structures and organize files, Move and copy files between folders, Share files and manage permissions, Export Google Docs to PDF or DOCX, Sync files between Drive and other systems, Automate document organization workflows, Manage shared drive content

Dynamic MCP Setup

Connect once through AgentPMT Dynamic MCP, then use approved tools from the same agent connection.

30 Second Setup

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections.

npm install -g @agentpmt/mcp-routeragentpmt-setup

Hosted Streamable HTTPS

MCP endpoint for browser-based apps like ChatGPT, Claude, Grok, or any time you want a streamable connection with no local install.

https://api.agentpmt.com/mcp

Config Example

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Full connection guide

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

Need client videos, organization controls, audit details, and the full feature overview?

More About Dynamic MCP

Credentials

Google OAuth *

Connect your Google account.

oauth token

Manage credentials in your dashboard.

Actions(12)

search_files^5cr10 params

Search for files and folders in Google Drive by text, MIME type, or folder location.

querystring

Plain-text search matched against full text and file name

raw_querystring

Advanced Drive query string (q=...). If provided, overrides query and other filters.

mime_typestring

Filter by MIME type. Accepts aliases: folder, document, spreadsheet, presentation, drawing. Or a full MIME type string.

folder_idstring

Restrict to a specific folder by ID. Use 'root' for My Drive root.

folder_pathstring

Restrict to a folder by path (e.g., 'Projects/Client A'), resolved under folder_id or root.

trashedboolean

If true, include trashed items (default false)

Default: false

page_sizeinteger

Max results per page (default 25, max 1000)

Default: 25

Range: 1 - 1000

page_tokenstring

Pagination token from a previous response

order_bystring

Drive orderBy string (default 'modifiedTime desc')

Default: modifiedTime desc

include_shared_drivesboolean

Include items from shared drives (default true)

Default: true

get_file_metadata^5cr2 params(1 required)

Retrieve metadata for a specific file or folder.

file_idrequiredstring

Drive file or folder ID

include_shared_drivesboolean

Include shared drives (default true)

Default: true

download_file_to_storage^5cr7 params(1 required)

Download a file from Drive and store it in temporary AgentPMT storage. Google Docs/Sheets/Slides are automatically exported (Docs to PDF, Sheets to XLSX, Slides to PPTX by default).

file_idrequiredstring

Drive file ID to download

export_formatstring

Override export format for Google Workspace files

Values:

pdftxthtmldocxxlsxpptxodtrtfepubzipcsvtsv

output_filenamestring

Override the stored filename

max_bytesinteger

Safety limit for download size in bytes (default 25 MiB, max 250 MiB)

Default: 26214400

Range: 1 - 262144000

expiration_daysinteger

Days until the stored file expires (default 7, range 1-7)

Default: 7

Range: 1 - 7

acknowledge_abuseboolean

Allow downloading files flagged as abusive (non-Google files only, default false)

Default: false

include_shared_drivesboolean

Include shared drives (default true)

Default: true

upload_file_from_storage^5cr11 params

Upload a file into Google Drive. Provide exactly one source: source_content_base64 (requires filename), source_file_url, or source_file_id. Local file paths are NOT supported.

source_file_idstring

AgentPMT storage file_id to upload into Drive

source_file_urlstring

Public URL to fetch and upload into Drive

source_content_base64string

Base64-encoded content to upload into Drive

filenamestring

Filename for the uploaded file (required with source_content_base64, optional otherwise)

content_typestring

MIME type override for upload (inferred from filename if omitted)

parent_folder_idstring

Destination folder ID (provide only one of parent_folder_id or parent_folder_path)

parent_folder_pathstring

Destination folder path (e.g., 'Projects/Reports')

create_parent_foldersboolean

Auto-create missing folders in parent_folder_path (default false)

Default: false

folder_idstring

Root context for resolving parent_folder_path (defaults to My Drive root)

max_upload_bytesinteger

Safety limit for upload size in bytes (default 25 MiB, max 250 MiB)

Default: 26214400

Range: 1 - 262144000

include_shared_drivesboolean

Include shared drives (default true)

Default: true

create_folder^5cr6 params(1 required)

Create a new folder in Google Drive.

folder_namerequiredstring

Name of the new folder

parent_folder_idstring

Parent folder ID (provide only one of parent_folder_id or parent_folder_path)

parent_folder_pathstring

Parent folder path

create_parent_foldersboolean

Auto-create missing parent folders (default false)

Default: false

folder_idstring

Root context for resolving parent_folder_path (defaults to My Drive root)

include_shared_drivesboolean

Include shared drives (default true)

Default: true

ensure_folder_path^5cr3 params(1 required)

Ensure a full folder path exists, creating any missing segments. Returns the final folder ID.

ensure_pathrequiredstring

Folder path to ensure (e.g., 'Projects/Client A/Deliverables')

folder_idstring

Root folder ID to resolve path under (defaults to My Drive root)

include_shared_drivesboolean

Include shared drives (default true)

Default: true

move_file^5cr7 params(1 required)

Move a file or folder to a different location in Google Drive.

file_idrequiredstring

The file or folder ID to move

destination_folder_idstring

Destination folder ID (provide only one of destination_folder_id or destination_folder_path)

destination_folder_pathstring

Destination folder path

remove_existing_parentsboolean

Remove the file from its current parent(s) (default true). If false, destination is added as an additional parent.

Default: true

create_parent_foldersboolean

Auto-create missing folders in destination_folder_path (default false)

Default: false

folder_idstring

Root context for resolving destination_folder_path

include_shared_drivesboolean

Include shared drives (default true)

Default: true

copy_file^5cr7 params(1 required)

Create a copy of a file in Google Drive.

file_idrequiredstring

The file ID to copy

new_namestring

Name for the copy

parent_folder_idstring

Destination folder ID (provide only one of parent_folder_id or parent_folder_path)

parent_folder_pathstring

Destination folder path

create_parent_foldersboolean

Auto-create missing folders (default false)

Default: false

folder_idstring

Root context for resolving parent_folder_path

include_shared_drivesboolean

Include shared drives (default true)

Default: true

trash_file^5cr2 params(1 required)

Move a file or folder to the trash (recoverable).

file_idrequiredstring

The file or folder ID to trash

include_shared_drivesboolean

Include shared drives (default true)

Default: true

delete_file^5cr2 params(1 required)

Permanently delete a file or folder (not recoverable).

file_idrequiredstring

The file or folder ID to permanently delete

include_shared_drivesboolean

Include shared drives (default true)

Default: true

share_file^5cr5 params(2 required)

Share a file or folder by creating a permission.

file_idrequiredstring

The file or folder ID to share

permissionrequiredobject

Permission details

Properties:

permission_type*(string)- Permission type

role*(string)- Permission role

email(string)- Email for user/group permissions. Also accepts emailAddress as alias.

domain(string)- Domain for domain-type permissions

allow_file_discovery(boolean)- For anyone/domain types, allow discovery via search (default false)

send_notificationboolean

Send email notification for user/group shares (default true)

Default: true

email_messagestring

Custom message in the notification email

include_shared_drivesboolean

Include shared drives (default true)

Default: true

list_permissions^5cr2 params(1 required)

List all permissions on a file or folder.

file_idrequiredstring

The file or folder ID

include_shared_drivesboolean

Include shared drives (default true)

Default: true

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "697bb62731d2bd755ac04037",
    "parameters": {
      "action": "search_files",
      "trashed": false,
      "page_size": 25,
      "order_by": "modifiedTime desc",
      "include_shared_drives": true
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "697bb62731d2bd755ac04037",
    "parameters": {
        "action": "search_files",
        "trashed": false,
        "page_size": 25,
        "order_by": "modifiedTime desc",
        "include_shared_drives": true
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "697bb62731d2bd755ac04037",
  parameters: {
    "action": "search_files",
    "trashed": false,
    "page_size": 25,
    "order_by": "modifiedTime desc",
    "include_shared_drives": true
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "697bb62731d2bd755ac04037",
  parameters: {
    "action": "search_files",
    "trashed": false,
    "page_size": 25,
    "order_by": "modifiedTime desc",
    "include_shared_drives": true
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below.

Recommended

Credit-Based Access Using AgentAddress

AgentAddress is preferred when an autonomous agent needs persistent file access, stored platform state, or maximum tool use ability across repeated calls.

Open Credit-Based Access Using AgentAddress

Direct x402 Payment

Use direct x402 for independent one-off tool calls that do not require shared files or stored platform state.

Accepted public payments

Stablecoin: USDC
Chains: Base, Arbitrum, Optimism, Polygon, and Avalanche

Direct x402 payments are not enabled for this product; use AgentAddress credit access instead.

Product Skill Package

This product has a published Agent Skill package. Install it when an autonomous agent needs product-specific operating instructions in its local skill registry.

Download SKILL.md View package source OpenClaw listing

OpenClaw install

skills.sh install

Usage Instructions

Usage guidance provided directly by the developer for this product.

Google Drive

Overview

Search, upload, download, organize, and share Google Drive files and folders. Supports My Drive and shared drives, folder path resolution, file export/conversion, and permission management.

Actions

search_files

Search for files and folders in Google Drive by text, MIME type, or folder location.

Required fields: None (returns all non-trashed files by default)

Optional fields:

query (string) - Plain-text search matched against full text and file name
raw_query (string) - Advanced Drive query string (used directly as the q parameter). If provided, overrides query and other filters
mime_type (string) - Filter by MIME type. Accepts aliases: folder, document, spreadsheet, presentation, drawing, or a full MIME type string
folder_id (string) - Restrict to a specific folder by ID. Use "root" for My Drive root
folder_path (string) - Restrict to a folder by path (e.g., "Projects/Client A"), resolved under folder_id or root
trashed (boolean, default: false) - If true, include trashed items
page_size (integer, default: 25, max: 1000) - Results per page
page_token (string) - Pagination token from a previous response's next_page_token
order_by (string, default: "modifiedTime desc") - Sort order
include_shared_drives (boolean, default: true) - Include items from shared drives

{
  "action": "search_files",
  "query": "quarterly report",
  "mime_type": "document",
  "page_size": 10
}

{
  "action": "search_files",
  "folder_path": "Finance/2026",
  "mime_type": "spreadsheet"
}

{
  "action": "search_files",
  "raw_query": "mimeType='application/pdf' and modifiedTime > '2026-01-01T00:00:00'"
}

get_file_metadata

Retrieve metadata for a specific file or folder.

Required fields:

file_id (string) - The Drive file or folder ID

{
  "action": "get_file_metadata",
  "file_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms"
}

download_file_to_storage

Download a file from Drive and store it in temporary storage. Google Docs/Sheets/Slides are automatically exported (Docs to PDF, Sheets to XLSX, Slides to PPTX by default).

Required fields:

file_id (string) - The Drive file ID

Optional fields:

export_format (string, enum: pdf, txt, html, docx, xlsx, pptx, odt, rtf, epub, zip, csv, tsv) - Override the export format for Google Workspace files
output_filename (string) - Override the stored filename
max_bytes (integer, default: 26214400 / 25 MiB, max: 262144000 / 250 MiB) - Safety limit for download size
expiration_days (integer, default: 7, range: 1-7) - Days until the stored file expires
acknowledge_abuse (boolean, default: false) - Allow downloading files flagged as abusive (non-Google files only)

{
  "action": "download_file_to_storage",
  "file_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
  "export_format": "docx"
}

{
  "action": "download_file_to_storage",
  "file_id": "1abc123def456",
  "output_filename": "invoice_march.pdf",
  "expiration_days": 3
}

upload_file_from_storage

Upload a file into Google Drive. Provide exactly one source. Files under 10 MiB use multipart upload; larger files use resumable upload automatically.

Required fields (exactly one):

source_content_base64 (string) - Base64-encoded file content. Requires filename
source_file_url (string) - Public URL to fetch content from
source_file_id (string) - File ID from AgentPMT storage (from a previous download or upload)

Optional fields:

filename (string) - Filename for the uploaded file (required with source_content_base64, optional otherwise)
content_type (string) - MIME type override (inferred from filename if omitted)
parent_folder_id (string) - Destination folder ID (provide only one of parent_folder_id or parent_folder_path)
parent_folder_path (string) - Destination folder path (e.g., "Projects/Reports")
create_parent_folders (boolean, default: false) - Auto-create missing folders in parent_folder_path
max_upload_bytes (integer, default: 26214400 / 25 MiB, max: 262144000 / 250 MiB) - Safety limit for upload size

Local file paths are NOT supported. You cannot pass a filesystem path.

{
  "action": "upload_file_from_storage",
  "source_content_base64": "SGVsbG8gV29ybGQh",
  "filename": "greeting.txt",
  "parent_folder_path": "Documents/Notes",
  "create_parent_folders": true
}

{
  "action": "upload_file_from_storage",
  "source_file_url": "https://example.com/report.pdf",
  "filename": "annual_report_2026.pdf",
  "parent_folder_id": "1AbCdEfGhIjKlMnOpQrStUvWxYz"
}

{
  "action": "upload_file_from_storage",
  "source_file_id": "storage_abc123",
  "parent_folder_path": "Backups"
}

create_folder

Create a new folder in Google Drive.

Required fields:

folder_name (string) - Name of the new folder

Optional fields:

parent_folder_id (string) - Parent folder ID (provide only one of parent_folder_id or parent_folder_path)
parent_folder_path (string) - Parent folder path
create_parent_folders (boolean, default: false) - Auto-create missing parent folders
folder_id (string) - Root context for resolving parent_folder_path (defaults to My Drive root)

{
  "action": "create_folder",
  "folder_name": "March Invoices",
  "parent_folder_path": "Finance/2026",
  "create_parent_folders": true
}

ensure_folder_path

Ensure a full folder path exists, creating any missing segments. Returns the final folder ID.

Required fields:

ensure_path (string) - Folder path to ensure (e.g., "Projects/Client A/Deliverables")

Optional fields:

folder_id (string) - Root folder ID to resolve path under (defaults to My Drive root)

{
  "action": "ensure_folder_path",
  "ensure_path": "Projects/Client A/Deliverables/Q1"
}

move_file

Move a file or folder to a different location.

Required fields:

file_id (string) - The file or folder ID to move
One of: destination_folder_id (string) or destination_folder_path (string)

Optional fields:

remove_existing_parents (boolean, default: true) - If true, removes the file from its current parent(s). If false, the destination is added as an additional parent
create_parent_folders (boolean, default: false) - Auto-create missing folders in destination_folder_path
folder_id (string) - Root context for resolving destination_folder_path

{
  "action": "move_file",
  "file_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
  "destination_folder_path": "Archive/2025"
}

copy_file

Create a copy of a file.

Required fields:

file_id (string) - The file ID to copy

Optional fields:

new_name (string) - Name for the copy
parent_folder_id (string) - Destination folder ID (provide only one of parent_folder_id or parent_folder_path)
parent_folder_path (string) - Destination folder path
create_parent_folders (boolean, default: false) - Auto-create missing folders

{
  "action": "copy_file",
  "file_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
  "new_name": "Budget 2026 (Copy)",
  "parent_folder_path": "Finance/Templates"
}

trash_file

Move a file or folder to the trash (recoverable).

Required fields:

file_id (string) - The file or folder ID to trash

{
  "action": "trash_file",
  "file_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms"
}

delete_file

Permanently delete a file or folder (not recoverable).

Required fields:

file_id (string) - The file or folder ID to delete

{
  "action": "delete_file",
  "file_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms"
}

share_file

Share a file or folder by creating a permission.

Required fields:

file_id (string) - The file or folder ID to share
permission (object) - Permission details:
- type (string, enum: user, group, domain, anyone) - Permission type
- role (string, enum: reader, commenter, writer, organizer, fileOrganizer) - Permission role
- email (string) - Required for user or group types. Also accepts emailAddress as alias
- domain (string) - Required for domain type
- allow_file_discovery (boolean, default: false) - For anyone/domain types, allow discovery via search

Optional fields:

send_notification (boolean, default: true) - Send email notification (only for user/group types)
email_message (string) - Custom message in the notification email

{
  "action": "share_file",
  "file_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
  "permission": {
    "type": "user",
    "role": "writer",
    "email": "colleague@example.com"
  },
  "email_message": "Here is the project document for your review."
}

{
  "action": "share_file",
  "file_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
  "permission": {
    "type": "anyone",
    "role": "reader"
  },
  "send_notification": false
}

list_permissions

List all permissions on a file or folder.

Required fields:

file_id (string) - The file or folder ID

{
  "action": "list_permissions",
  "file_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms"
}

Common Workflows

1. Organize uploaded content into a folder structure

Use ensure_folder_path with ensure_path: "Projects/Client B/Assets" to create the full path
Use upload_file_from_storage with source_file_url or source_content_base64 and set parent_folder_path: "Projects/Client B/Assets"
Use share_file to grant the client read access

2. Download a Google Doc, convert, and reshare

Use search_files with query: "proposal draft" and mime_type: "document" to find the file
Use download_file_to_storage with the file_id and export_format: "docx" to get a Word version
The returned storage file ID can be used with other tools or re-uploaded elsewhere

3. Archive old files to a subfolder

Use search_files with folder_path: "Active Projects" to list files
Use ensure_folder_path with ensure_path: "Archive/2025" to ensure the archive folder exists
Use move_file for each file, setting destination_folder_path: "Archive/2025"

Important Notes

MIME type aliases: Use folder, document, spreadsheet, presentation, or drawing instead of full MIME strings when filtering searches
Folder path resolution: Paths use / separators (e.g., "Projects/Client A/Reports"). If a path segment matches multiple folders with the same name, the tool prefers the exact case match. If truly ambiguous, it returns candidate IDs so you can use the direct folder ID instead
Download size limits: Default 25 MiB, max 250 MiB. Increase max_bytes for larger files
Upload size limits: Default 25 MiB, max 250 MiB. Increase max_upload_bytes for larger files
Google Workspace exports: Google Docs export to PDF by default, Sheets to XLSX, Slides to PPTX, Drawings to PDF. Override with export_format
Shared drives: Included by default (include_shared_drives: true). Set to false to exclude
Trash vs delete: trash_file is recoverable; delete_file is permanent
Upload sources: Provide exactly one of source_file_id, source_file_url, or source_content_base64. Local filesystem paths are not supported
Downloaded files are stored temporarily and expire after expiration_days (default 7, max 7)
Pagination: When results exceed page_size, the response includes next_page_token. Pass it as page_token in the next request to get the next page

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get_instructions' so you know how to use the tool search interface. Then call action 'get_schema' with tool_id 697bb62731d2bd755ac04037 ("Google Drive"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Google Drive

Available ActionsEach successful request consumes credits as outlined below.

Details

Workflows Using This Tool

Plaud Call Logger for Pipedrive

Use Cases

Dynamic MCP Setup

30 Second Setup

Hosted Streamable HTTPS

Config Example

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Looking for help integrating AI into your business? Set up a free consultation.