# Google Drive

MCP server for Google Drive API v3 : search, read, create, share, and manage files and folders.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add node2flow/google-drive

# Browse available tools
npx -y @smithery/cli@latest tool list node2flow/google-drive

# Get full schema for a tool
npx -y @smithery/cli@latest tool get node2flow/google-drive gd_search_files

# Call a tool
npx -y @smithery/cli@latest tool call node2flow/google-drive gd_search_files '{}'
```

## Direct MCP Connection

Endpoint: `https://google-drive--node2flow.run.tools`

**Required config:**
- `GOOGLE_CLIENT_ID` (query) — OAuth 2.0 Client ID from Google Cloud Console
- `GOOGLE_CLIENT_SECRET` (query) — OAuth 2.0 Client Secret
- `GOOGLE_REFRESH_TOKEN` (query) — OAuth 2.0 Refresh Token (obtained via consent flow with drive scope)

## Tools (23)

- `gd_search_files` — Search and list files in Google Drive. Use the q parameter for powerful search queries: name contains, mimeType, parent…
- `gd_get_file` — Get detailed metadata for a specific file or folder by ID. Returns all available metadata fields including size, owners…
- `gd_read_file` — Read/download file content. Returns text content for text-based files (txt, csv, json, html, xml, code). For binary fil…
- `gd_create_file` — Create a new file or Google Workspace document (metadata only, no content upload). To create a folder, use gd_create_fo…
- `gd_update_file` — Update file metadata — rename, change description, star/unstar, move between folders, or trash/untrash. Use add_parents…
- `gd_copy_file` — Create a copy of a file. Optionally specify a new name, destination folder, or description for the copy.
- `gd_delete_file` — Permanently delete a file or folder. This action is irreversible — the file will NOT go to trash. Use gd_update_file wi…
- `gd_export_file` — Export a Google Workspace file (Docs, Sheets, Slides, Drawings) to a standard format. Use this for Google-native files;…
- `gd_create_folder` — Create a new folder in Google Drive. Optionally specify a parent folder to create it as a subfolder.
- `gd_empty_trash` — Permanently delete ALL files in the trash. This action is irreversible. All trashed files for the authenticated user wi…
- `gd_list_permissions` — List all permissions (sharing settings) for a file or folder. Shows who has access, their role (owner, writer, commente…
- `gd_share_file` — Share a file or folder by creating a permission. Share with a specific user (email), domain, or make public (anyone). S…
- `gd_unshare_file` — Remove a permission from a file or folder, revoking access for a user, group, or domain. Use gd_list_permissions to fin…
- `gd_list_comments` — List comments on a file. Returns comment text, author, timestamps, resolved status, and inline replies.
- `gd_create_comment` — Add a comment to a file. The comment will be attributed to the authenticated user.
- `gd_delete_comment` — Delete a comment from a file. Only the comment author or file owner can delete comments.
- `gd_list_replies` — List replies to a specific comment on a file.
- `gd_create_reply` — Reply to a comment on a file. Optionally resolve the comment thread with action="resolve".
- `gd_list_drives` — List shared drives (formerly Team Drives) that the user has access to. Supports search query for filtering by name.
- `gd_create_drive` — Create a new shared drive (requires Google Workspace account). The authenticated user becomes the organizer.
- `gd_delete_drive` — Permanently delete a shared drive. The drive must be empty (no files) before it can be deleted. This action is irrevers…
- `gd_list_revisions` — List revision history for a file. Shows who modified the file, when, file size at each revision, and checksums.
- `gd_about` — Get information about the authenticated user and their Google Drive — storage quota, import/export formats, and capabil…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get node2flow/google-drive <tool-name>
```

## Resources

- `google-drive://server-info` — Connection status and available tools for this Google Drive MCP server

## Prompts (2)

- `search-and-organize` — Guide for searching, browsing, and organizing files in Google Drive
- `collaborate-and-comment` — Guide for sharing files, managing permissions, and working with comments

---

License: MIT