Google Drive
A Model Context Protocol (MCP) server that provides secure integration with Google Drive, Docs, Sheets, Slides and Calendar. It allows Claude Desktop and other MCP clients to manage files in Google Drive through a standardized interface.
What is Google Drive?
Google Drive is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server that provides secure integration with google drive, docs, sheets, slides and calendar. it allows claude desktop and other mcp clients to manage files in google driv...
A Model Context Protocol (MCP) server that provides secure integration with Google Drive, Docs, Sheets, Slides and Calendar. It allows Claude Desktop and other MCP clients to manage files in Google Drive through a standardized interface.
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol (MCP) server that provides secure i
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @us-all/google-drive-mcpManual Installation
npx -y @us-all/google-drive-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Google Drive
The Google Drive MCP server (@us-all/google-drive-mcp) provides secure, comprehensive integration between Claude and the full Google Workspace suite — Drive, Docs, Sheets, Slides, and Calendar — exposing 98 tools that cover file CRUD, rich Sheets editing (formulas, conditional formatting, charts), Slides presentation management, Docs text and element editing, Shared Drive administration, and permission auditing. It supports three authentication modes (OAuth2, Service Account with domain-wide delegation, and Application Default Credentials) and is a more feature-complete alternative to Anthropic's built-in Google Drive connector, particularly for Sheets formula work and Workspace admin tasks.
Prerequisites
- Node.js 18 or higher (for npx)
- A Google Cloud project with the Drive, Docs, Sheets, Slides, Drive Activity, and Drive Labels APIs enabled
- OAuth2 credentials (client ID, client secret, refresh token) for personal use, or a Service Account JSON key for organization-wide deployment
- An MCP client such as Claude Desktop or Claude Code
Create a Google Cloud project and enable APIs
Go to the Google Cloud Console, create or select a project, and enable the following APIs: Google Drive API, Google Docs API, Google Sheets API, Google Slides API, Drive Activity API, and Drive Labels API.
Generate OAuth2 credentials and a refresh token
In the Cloud Console under Credentials, create an OAuth2 Desktop App client. Download the credentials JSON, then use the OAuth2 flow to obtain a refresh token with the appropriate Drive/Docs/Sheets/Slides scopes.
Add the server to Claude Desktop
Add the configuration block to your Claude Desktop config file, inserting your OAuth2 credentials in the env section.
{
"mcpServers": {
"google-drive": {
"command": "npx",
"args": ["-y", "@us-all/google-drive-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "your-client-secret",
"GOOGLE_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}Or add via Claude Code CLI
Claude Code users can add the server with a single command, which writes the config automatically.
claude mcp add google-drive -s user -- npx -y @us-all/google-drive-mcpRestrict active tool categories (optional)
Use the GD_TOOLS env var to limit which tool categories are loaded. This reduces the token footprint when you only need a subset of capabilities.
"env": {
"GOOGLE_CLIENT_ID": "...",
"GOOGLE_CLIENT_SECRET": "...",
"GOOGLE_REFRESH_TOKEN": "...",
"GD_TOOLS": "drive,sheets,docs",
"GOOGLE_DRIVE_ALLOW_WRITE": "true"
}Restart your client and test
Restart Claude Desktop. Ask Claude to list files in your Drive to verify the connection.
Google Drive Examples
Client configuration
Full Claude Desktop configuration with OAuth2 credentials and write access enabled.
{
"mcpServers": {
"google-drive": {
"command": "npx",
"args": ["-y", "@us-all/google-drive-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "your-client-secret",
"GOOGLE_REFRESH_TOKEN": "your-refresh-token",
"GOOGLE_DRIVE_ALLOW_WRITE": "true",
"GD_TOOLS": "drive,sheets,docs,slides"
}
}
}
}Prompts to try
Examples of high-value tasks you can perform through Claude once the server is connected.
- "List all spreadsheets shared with me in the last 30 days that I haven't opened"
- "Apply conditional formatting to the 'Revenue' column in my Q4 Sales sheet: red for negative, green for positive"
- "Convert the outline in my Product Brief doc into a 10-slide presentation with one slide per heading"
- "Audit all Shared Drives and list anyone outside our domain who has editor access"
- "Find all files in my Drive larger than 100MB and list their owners"Troubleshooting Google Drive
Authentication fails with 'invalid_grant' or 'Token has been expired or revoked'
Your refresh token has expired or been revoked. Go through the OAuth2 flow again to generate a new refresh token and update GOOGLE_REFRESH_TOKEN in your config.
API returns 403 'The caller does not have permission'
Ensure all required APIs (Drive, Docs, Sheets, Slides, Drive Activity, Drive Labels) are enabled in your Google Cloud project. Also verify your OAuth2 scopes include the necessary Drive and Docs scopes.
Too many tools loaded, causing slow responses or token limit issues
Set the GD_TOOLS environment variable to only the categories you need (e.g., 'drive,sheets'). This reduces the number of active tools from 98 to a focused subset.
Frequently Asked Questions about Google Drive
What is Google Drive?
Google Drive is a Model Context Protocol (MCP) server that model context protocol (mcp) server that provides secure integration with google drive, docs, sheets, slides and calendar. it allows claude desktop and other mcp clients to manage files in google drive through a standardized interface. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Google Drive?
Install via npm with the command: npx -y @us-all/google-drive-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Google Drive?
Google Drive works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Google Drive free to use?
Yes, Google Drive is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Google Drive Alternatives — Similar Cloud Services Servers
Looking for alternatives to Google Drive? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务,帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Google Drive in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Google Drive?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.