GDrive MCP Server

A comprehensive Model Context Protocol (MCP) server for Google Drive, Google Docs, and Google Sheets with full tool support across all Google Drive functions.

Installation

# Global install (recommended)
npm install -g @pouyanafisi/googledrive-mcp

# Or as a project dependency
npm install @pouyanafisi/googledrive-mcp

# Or clone from source
git clone https://github.com/pouyanafisi/gdrive-mcp.git
cd gdrive-mcp
npm install

Features

• 50+ MCP Tools for complete Google Drive management
• Automatic MIME type detection for 80+ file extensions
• Native Google Workspace support - Docs, Sheets, Slides, Forms
• Full CRUD operations - Create, Read, Update, Delete for all file types
• Folder management - Create hierarchies, move, search
• OAuth2 authentication - Secure Google API access

Setup

1. Create Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project
3. Enable the following APIs:
   • Google Drive API
   • Google Docs API
   • Google Sheets API

2. Create OAuth Credentials

1. Go to APIs & Services > Credentials
2. Create OAuth 2.0 Client ID (Desktop app)
3. Download the JSON file
4. Rename to gcp-oauth.keys.json
5. Place in project root or ~/.gdrive-mcp/

3. Authenticate

npm run auth

This opens a browser for OAuth authentication.

Usage

MCP Client Configuration

Add to your MCP client (Claude, Cursor, etc.):

{
  "mcpServers": {
    "gdrive": {
      "command": "googledrive-mcp"
    }
  }
}

Or if installed locally:

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["@pouyanafisi/googledrive-mcp"]
    }
  }
}

---

Tools Reference

File Operations (16 tools)

Tool	Description
search_files	Search for files in Google Drive using queries
get_file	Get file metadata by ID
create_file	Create a new file with auto type detection
upload_file	Upload file with automatic MIME type from extension
create_google_doc	Create a new Google Doc
create_google_sheet	Create a new Google Sheet
create_google_slides	Create a new Google Slides presentation
update_file	Update file metadata (name, description)
delete_file	Delete a file (trash or permanent)
move_file	Move a file to a different folder
copy_file	Copy a file
download_file	Download file content
export_file	Export Google Workspace file (PDF, DOCX, XLSX, etc.)
list_recent_files	List recently viewed files
list_shared_files	List files shared with me
list_trashed_files	List files in trash

Folder Operations (9 tools)

Tool	Description
create_folder	Create a new folder
get_folder	Get folder metadata
list_folders	List all folders or within a parent
list_folder_contents	List all files and folders in a folder
update_folder	Rename a folder
move_folder	Move a folder to a new location
delete_folder	Delete a folder (trash or permanent)
create_folder_path	Create nested folder structure (e.g., "Projects/2024/Reports")
search_folders	Search folders by name

Google Docs Operations (10 tools)

Tool	Description
create_document	Create a new Google Doc with optional content
read_document	Read text content from a Google Doc
update_document	Replace all content in a Google Doc
append_to_document	Append text to end of document
replace_in_document	Find and replace text
add_heading	Add a formatted heading (H1-H6)
add_bullet_list	Add a bullet list
list_documents	List all Google Docs
search_documents	Search Google Docs by name
export_document	Export to PDF, DOCX, TXT, or HTML

Google Sheets Operations (15 tools)

Tool	Description
create_spreadsheet	Create a new Google Sheet
get_spreadsheet_info	Get spreadsheet metadata and sheet list
read_spreadsheet	Read values from a range (e.g., "A1:D10")
read_sheet	Read an entire sheet
write_spreadsheet	Write values to a range
append_to_spreadsheet	Append rows to a sheet
clear_spreadsheet	Clear values from a range
add_sheet	Add a new sheet tab
delete_sheet	Delete a sheet tab
rename_sheet	Rename a sheet tab
find_replace_in_spreadsheet	Find and replace across all sheets
list_spreadsheets	List all Google Sheets
search_spreadsheets	Search Google Sheets by name
export_spreadsheet	Export to XLSX, CSV, or PDF
create_spreadsheet_from_csv	Create spreadsheet from CSV data

---

Supported File Types

Automatic MIME Type Detection

The server automatically detects file types from extensions. Just use the correct extension and the file will be created with the proper MIME type.

Text & Markup

Extension	MIME Type	Description
.txt	text/plain	Plain text
.md, .markdown	text/markdown	Markdown
.csv	text/csv	CSV data
.tsv	text/tab-separated-values	Tab-separated
.xml	application/xml	XML
.yaml, .yml	text/yaml	YAML
.html, .htm	text/html	HTML
.css	text/css	CSS
.json	application/json	JSON

Programming Languages

Extension	MIME Type	Description
.js, .mjs	text/javascript	JavaScript
.ts	text/typescript	TypeScript
.jsx, .tsx	text/javascript	React
.py	text/x-python	Python
.rb	text/x-ruby	Ruby
.php	text/x-php	PHP
.java	text/x-java	Java
.c, .h	text/x-c	C
.cpp, .hpp	text/x-c++	C++
.cs	text/x-csharp	C#
.go	text/x-go	Go
.rs	text/x-rust	Rust
.swift	text/x-swift	Swift
.kt	text/x-kotlin	Kotlin
.scala	text/x-scala	Scala
.sql	text/x-sql	SQL
.sh, .bash, .zsh	text/x-shellscript	Shell
.ps1	text/x-powershell	PowerShell
.r	text/x-r	R
.lua	text/x-lua	Lua
.pl, .pm	text/x-perl	Perl

Documents

Extension	MIME Type	Description
.pdf	application/pdf	PDF
.doc	application/msword	Word (legacy)
.docx	application/vnd.openxmlformats-officedocument.wordprocessingml.document	Word
.rtf	application/rtf	Rich Text
.odt	application/vnd.oasis.opendocument.text	OpenDocument

Spreadsheets

Extension	MIME Type	Description
.xls	application/vnd.ms-excel	Excel (legacy)
.xlsx	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	Excel
.ods	application/vnd.oasis.opendocument.spreadsheet	OpenDocument

Presentations

Extension	MIME Type	Description
.ppt	application/vnd.ms-powerpoint	PowerPoint (legacy)
.pptx	application/vnd.openxmlformats-officedocument.presentationml.presentation	PowerPoint
.odp	application/vnd.oasis.opendocument.presentation	OpenDocument

Images

Extension	MIME Type	Description
.jpg, .jpeg	image/jpeg	JPEG
.png	image/png	PNG
.gif	image/gif	GIF
.webp	image/webp	WebP
.svg	image/svg+xml	SVG
.bmp	image/bmp	Bitmap
.tiff, .tif	image/tiff	TIFF
.ico	image/x-icon	Icon

Audio

Extension	MIME Type	Description
.mp3	audio/mpeg	MP3
.wav	audio/wav	WAV
.ogg	audio/ogg	OGG
.flac	audio/flac	FLAC
.aac	audio/aac	AAC
.m4a	audio/mp4	M4A

Video

Extension	MIME Type	Description
.mp4	video/mp4	MP4
.webm	video/webm	WebM
.avi	video/x-msvideo	AVI
.mov	video/quicktime	QuickTime
.wmv	video/x-ms-wmv	WMV
.mkv	video/x-matroska	Matroska

Archives

Extension	MIME Type	Description
.zip	application/zip	ZIP
.tar	application/x-tar	TAR
.gz	application/gzip	GZIP
.rar	application/vnd.rar	RAR
.7z	application/x-7z-compressed	7-Zip

Google Workspace

Extension	MIME Type	Description
.gdoc	application/vnd.google-apps.document	Google Doc
.gsheet	application/vnd.google-apps.spreadsheet	Google Sheet
.gslides	application/vnd.google-apps.presentation	Google Slides
.gform	application/vnd.google-apps.form	Google Form
.gdraw	application/vnd.google-apps.drawing	Google Drawing

---

Examples

Upload files with auto type detection

// These automatically get the correct MIME type
await fileService.uploadFile('readme.md', markdownContent, folderId);
await fileService.uploadFile('config.json', jsonContent, folderId);
await fileService.uploadFile('data.csv', csvContent, folderId);
await fileService.uploadFile('script.py', pythonCode, folderId);

Create Google Workspace files

// Create native Google files
await documentService.createDocument('Meeting Notes', 'Initial content');
await spreadsheetService.createSpreadsheet('Budget 2024');
await fileService.createFile('Presentation.gslides');

Folder operations

// Create nested folder structure
const folder = await folderService.getOrCreateFolderPath('Projects/2024/Q1');

// List folder contents
const files = await folderService.listFolderContents(folderId);

---

Configuration

Environment Variable	Description
GDRIVE_OAUTH_PATH	Path to OAuth keys file
GDRIVE_CREDENTIALS_PATH	Path to credentials file

Development

npm run build      # Build TypeScript
npm run dev        # Watch mode
npm run type-check # Type checking
npm test           # Run tests

License

MIT © Pouya Nafisi