How do I use google-drive-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@google-drive-mcp List all files in the folder named 'Projects'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

google-drive-mcp

by software-engineer-mj

Overview Schema Related Servers Score Discussions

Python

Google Drive MCP Server

A Model Context Protocol (MCP) server for Google Drive API v3, enabling AI agents like Claude to manage Google Drive files, folders, and sharing.

Provides 26 tools across 9 categories for comprehensive Google Drive management.

Features

Category	Tools	Description
Files	10	List, search, full-text search, read, upload, update, append, export files
Trash	3	Trash, restore, list trash
Folders	1	Create folders
Organization	2	Move, copy files
Sharing	5	Share files, manage permissions, create share links
Metadata	2	Get/update file info
Revisions	2	List revision history, download specific versions
Shared Drives	2	List shared drives, get shared drive info
Utilities	1	Recently accessed files

Related MCP server: MCP Google Workspace Server

Requirements

Python >= 3.10
uv (recommended) or pip
Google Cloud project with Drive API enabled
OAuth 2.0 credentials (from Google Cloud Console)

Setup

1. Google Cloud Project

Go to Google Cloud Console and create a new project
Enable Google Drive API at APIs & Services > Library
Create credentials at APIs & Services > Credentials:
- OAuth 2.0 Client ID (Desktop app)
Download the credentials JSON file

2. Installation

git clone https://github.com/software-engineer-mj/google-drive-mcp.git
cd google-drive-mcp
uv sync

3. Configuration

cp .env.example .env

Variable	Required	Description
`GOOGLE_DRIVE_CREDENTIALS_PATH`	Yes	Path to OAuth 2.0 credentials JSON
`GOOGLE_DRIVE_TOKEN_PATH`	No	OAuth token storage path (default: `token.json`)
`GOOGLE_DRIVE_MAX_DOWNLOAD_MB`	No	Maximum download size in MB (default: 10)

Authentication

On first run, a browser will open for Google account authorization. After approval, token.json is created and refreshed automatically.

Note: Never commit credentials.json or token.json to version control. They are already in .gitignore.

Usage

stdio (default)

uv run python -m google_drive_mcp

Docker

docker build -t google-drive-mcp .

docker run -v /path/to/credentials.json:/app/credentials.json \
           -e GOOGLE_DRIVE_CREDENTIALS_PATH=/app/credentials.json \
           google-drive-mcp

MCP Client Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "google-drive": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/google-drive-mcp", "python", "-m", "google_drive_mcp"],
      "env": {
        "GOOGLE_DRIVE_CREDENTIALS_PATH": "/path/to/credentials.json",
        "GOOGLE_DRIVE_TOKEN_PATH": "/path/to/token.json"
      }
    }
  }
}

Claude Code

Add to .mcp.json:

{
  "mcpServers": {
    "google-drive": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/google-drive-mcp", "python", "-m", "google_drive_mcp"],
      "env": {
        "GOOGLE_DRIVE_CREDENTIALS_PATH": "/path/to/credentials.json",
        "GOOGLE_DRIVE_TOKEN_PATH": "/path/to/token.json"
      }
    }
  }
}

Development

# Install with dev dependencies
uv sync --dev

# Run tests
uv run pytest tests/ -v

# Lint
uv run ruff check src/ tests/

# Format
uv run ruff format src/ tests/

Tool Reference

Files (10)

Tool	Description
`list_files`	List files in Drive, optionally within a folder
`search_files`	Search files using Drive query syntax
`search_file_content`	Search files by their text content (full-text search)
`read_file`	Read file content (Google Docs/Sheets/Slides auto-exported to text/CSV)
`upload_file`	Upload a text file
`upload_binary_file`	Upload a binary file (base64-encoded)
`update_file_content`	Update existing file content
`append_to_file`	Append text to the end of an existing text file
`export_file`	Export Google Workspace file to PDF, DOCX, XLSX, etc.
`create_google_doc`	Create a new Google Docs, Sheets, or Slides

Trash (3)

Tool	Description
`trash_file`	Move file to trash (recoverable)
`restore_file`	Restore file from trash
`list_trash`	List files in trash

Folders (1)

Tool	Description
`create_folder`	Create a new folder

Organization (2)

Tool	Description
`move_file`	Move file to a different folder
`copy_file`	Copy a file

Tool	Description
`share_file`	Share file by email (reader/writer/commenter/owner)
`list_permissions`	List file permissions
`remove_permission`	Remove a permission
`create_share_link`	Create "anyone with link" share link
`update_permission`	Update existing permission role

Metadata (2)

Tool	Description
`get_file_info`	Get detailed file metadata
`update_metadata`	Update file name/description

Revisions (2)

Tool	Description
`list_revisions`	List file revision history
`get_revision`	Download specific revision content

Shared Drives (2)

Tool	Description
`list_shared_drives`	List all shared drives the user has access to
`get_shared_drive`	Get metadata for a specific shared drive

Utilities (1)

Tool	Description
`list_recent`	List recently accessed files

Google Docs Auto-Conversion

read_file automatically converts Google Workspace files:

Source Format	Export Format
Google Docs	Plain Text
Google Sheets	CSV
Google Slides	Plain Text

export_file supports additional formats:

Source Format	Supported Formats
Google Docs	pdf, docx, odt, txt, html
Google Sheets	pdf, xlsx, ods, csv, tsv
Google Slides	pdf, pptx, txt
Google Drawings	pdf, png, svg

Project Structure

src/google_drive_mcp/
├── __init__.py          # FastMCP server instance
├── __main__.py          # Entry point with auto-discovery
├── auth.py              # OAuth 2.0 authentication
├── client.py            # Google Drive API wrapper
├── exceptions.py        # Custom exception hierarchy
├── lifespan.py          # Server lifecycle management
├── utils.py             # MIME type mapping, helpers
├── validators.py        # Input validation utilities
└── tools/
    ├── __init__.py
    ├── drives.py        # Shared drives management
    ├── files.py         # File CRUD operations
    ├── folders.py       # Folder management
    ├── metadata.py      # File metadata
    ├── organization.py  # Move, copy
    ├── revisions.py     # Revision history
    ├── sharing.py       # Sharing and permissions
    ├── trash.py         # Trash operations
    └── utilities.py     # Recently accessed files
tests/
├── conftest.py
├── test_auth.py
├── test_client.py
├── test_server.py
├── test_utils.py
└── tools/
    ├── conftest.py
    └── test_<domain>.py # Tests matching each tool module

License

MIT - see LICENSE for details.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

Google Drive MCP Server
Cloud Storage File Systems App Automation
hxie-pallas
A
license
-
quality
D
maintenance
A server that provides a Machine Control Protocol (MCP) interface to search, access, and interact with Google Drive files and folders, enabling AI assistants to work with Google Drive content.
Updated a year ago (2025-04-19 01:54 UTC)
8
MIT
MCP Google Workspace Server
App Automation Cloud Platforms Developer Tools
josedu90
A
license
A
quality
D
maintenance
A Model Context Protocol server that enables AI agents to interact with Google Workspace services including Drive, Docs, and Sheets through natural language commands.
Updated a year ago (2025-04-29 22:07 UTC)
8
MIT
Proton Drive MCP
Cloud Storage File Systems
anyrxo
A
license
A
quality
D
maintenance
A Model Context Protocol server that enables AI assistants to interact with Proton Drive files, supporting operations like listing, reading, creating, and deleting files and folders.
Updated 5 months ago (2026-03-07 00:11 UTC)
7
375
16
MIT
Google Drive MCP Server
Cloud Storage File Systems App Automation
pedrohzwang
F
license
B
quality
D
maintenance
An MCP server that enables integration with Google Drive through a service account to list files and retrieve detailed file metadata. It allows users to browse and inspect Drive contents using natural language via the Model Context Protocol.
Updated 7 months ago (2026-01-20 02:56 UTC)
2

View all related MCP servers

Related MCP Connectors

hithereiamaliff-mcp-nextcloud
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
CalendarMCP
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
microservices.sh
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/software-engineer-mj/google-drive-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Google Drive MCP Server

Features

Requirements

Setup

1. Google Cloud Project

2. Installation

3. Configuration

Authentication

Usage

stdio (default)

Docker

MCP Client Configuration

Claude Desktop

Claude Code

Development

Tool Reference

Files (10)

Trash (3)

Folders (1)

Organization (2)

Sharing (5)

Metadata (2)

Revisions (2)

Shared Drives (2)

Utilities (1)

Google Docs Auto-Conversion

Project Structure

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Google Drive MCP Server

MCP Google Workspace Server

Proton Drive MCP

Google Drive MCP Server

Related MCP Connectors

Latest Blog Posts

MCP directory API