@node2flow/google-drive-mcp

MCP server for Google Drive — search, read, create, share, comment, and manage files through 23 tools via the Model Context Protocol.

Quick Start

Claude Desktop / Cursor

Add to your MCP config:

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@node2flow/google-drive-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

HTTP Mode

GOOGLE_CLIENT_ID=xxx GOOGLE_CLIENT_SECRET=xxx GOOGLE_REFRESH_TOKEN=xxx npx @node2flow/google-drive-mcp --http

MCP endpoint: http://localhost:3000/mcp

Cloudflare Worker

Available at: https://google-drive-mcp-community.node2flow.net/mcp

POST https://google-drive-mcp-community.node2flow.net/mcp?GOOGLE_CLIENT_ID=xxx&GOOGLE_CLIENT_SECRET=xxx&GOOGLE_REFRESH_TOKEN=xxx

---

Tools (23)

Files (10)

Tool	Description
gd_search_files	Search/list files with powerful query syntax (name, type, folder, date)
gd_get_file	Get detailed metadata for a file or folder
gd_read_file	Read/download file content (text files)
gd_create_file	Create a new file or Google Workspace document
gd_update_file	Update metadata — rename, move, star, trash/untrash
gd_copy_file	Copy a file to a new location
gd_delete_file	Permanently delete a file (irreversible)
gd_export_file	Export Google Workspace files (Docs→text, Sheets→csv, etc.)
gd_create_folder	Create a new folder
gd_empty_trash	Permanently delete all trashed files

Permissions (3)

Tool	Description
gd_list_permissions	List who has access to a file
gd_share_file	Share with user, group, domain, or anyone
gd_unshare_file	Remove access for a user or group

Comments (3)

Tool	Description
gd_list_comments	List comments on a file
gd_create_comment	Add a comment to a file
gd_delete_comment	Delete a comment

Replies (2)

Tool	Description
gd_list_replies	List replies to a comment
gd_create_reply	Reply to a comment (optionally resolve thread)

Shared Drives (3)

Tool	Description
gd_list_drives	List shared drives
gd_create_drive	Create a shared drive (Workspace only)
gd_delete_drive	Delete an empty shared drive

Revisions (1)

Tool	Description
gd_list_revisions	List revision history for a file

About (1)

Tool	Description
gd_about	Get user info, storage quota, and Drive capabilities

---

Search Query Syntax

The q parameter in gd_search_files supports powerful queries:

# By name
name = 'exact-name.txt'
name contains 'report'

# By type
mimeType = 'application/vnd.google-apps.folder'
mimeType = 'application/vnd.google-apps.document'
mimeType = 'application/pdf'

# By location
'folderId' in parents

# By status
trashed = false
starred = true

# By date
modifiedTime > '2024-01-01'
createdTime > '2024-06-01T00:00:00'

# Full-text search
fullText contains 'quarterly report'

# Combine with and/or
name contains 'report' and mimeType = 'application/pdf'
trashed = false and modifiedTime > '2024-01-01'

---

Export Formats

Use gd_export_file to convert Google Workspace files:

Source	Export To
Google Docs	text/plain, text/html, application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document (docx)
Google Sheets	text/csv, application/pdf, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (xlsx)
Google Slides	application/pdf, text/plain, application/vnd.openxmlformats-officedocument.presentationml.presentation (pptx)
Google Drawings	image/png, image/svg+xml, application/pdf

---

Configuration

Parameter	Required	Description
GOOGLE_CLIENT_ID	Yes	OAuth 2.0 Client ID from Google Cloud Console
GOOGLE_CLIENT_SECRET	Yes	OAuth 2.0 Client Secret
GOOGLE_REFRESH_TOKEN	Yes	Refresh token (obtained via OAuth consent flow)

Getting Your Credentials

1. Go to Google Cloud Console
2. Create a project → Enable Google Drive API
3. Create OAuth 2.0 Client ID (Desktop app type)
4. Use the OAuth Playground or your app to get a refresh token with scope https://www.googleapis.com/auth/drive

OAuth Scopes

Scope	Access
drive	Full access (read/write/delete)
drive.readonly	Read-only access
drive.file	Only files created by or explicitly granted to the app

---

License

MIT License - see LICENSE

Copyright (c) 2026 Node2Flow

Links

• npm Package
• Google Drive API
• MCP Protocol
• Node2Flow