Google Drive MCP (mcp-gdrive)
Community server for searching and reading Google Drive files — the most referenced option in a fragmented ecosystem awaiting Google's official remote MCP.
Client Compatibility
What It Does
Connects Claude to Google Drive for searching files, reading documents, and working with Google Sheets. The most referenced community implementation (isaacphi/mcp-gdrive) provides focused read-heavy access: search Drive, read file contents by ID, and read/write spreadsheet data. Broader alternatives exist that add support for Docs, Slides, and full file CRUD, but they come with more complexity.
Important context: Google announced an official remote MCP server in December 2025 covering all Google services. That server is still rolling out incrementally, but it will likely become the definitive answer for Google Drive integration. This listing covers the best available community option while we wait.
What It Does Well
- Search and read workflow covers the core use case. Most users want to ask Claude about their Drive files — “find the Q4 budget spreadsheet” or “what does our project spec say about authentication.” The search tool finds files, the read tools pull content. For read-heavy workflows, the focused tool set is actually an advantage — less tool clutter.
- Google Sheets support goes beyond basic read. The
read_spreadsheettool accepts range and sheet parameters, so you can target specific data within large workbooks. Thewrite_spreadsheettool enables updating cells. For spreadsheet-centric workflows, this is more useful than generic file access. - Once configured, authentication persists. After the initial OAuth browser flow, credentials are cached locally. You don’t need to re-authenticate every session. The token refresh happens automatically until you revoke access.
What It Doesn’t Do Well
- Google Cloud Console setup is the worst onboarding in the MCP ecosystem. Create a Google Cloud project, enable the Drive API, configure the OAuth consent screen, create OAuth credentials, download the client ID and secret, set up the redirect URI — all before you can even try the MCP server. This multi-step process through Google’s notoriously complex console is the primary reason for the Conditional verdict.
- Fragmented ecosystem with no community standard. At least four Google Drive MCP servers exist: isaacphi/mcp-gdrive (focused, most referenced), piotr-agier/google-drive-mcp (broader with Docs/Sheets/Slides), taylorwilsdon/google_workspace_mcp (all-in-one including Gmail/Calendar), and the Anthropic reference implementation. Each has different capabilities and trade-offs. There’s no clear winner.
- Google’s official remote MCP will likely make this obsolete. Announced December 2025, Google’s managed remote MCP server handles Drive and other services with OAuth built in — no Cloud Console setup, no local install. As it rolls out to more clients, community servers lose their reason to exist. Investing heavily in configuring a community server that may be replaced soon is a tough sell.
Setup Notes
The hardest part is the Google Cloud Console setup. Here’s the abbreviated path: go to console.cloud.google.com, create a new project, navigate to “APIs & Services” → “Library,” search for “Google Drive API” and enable it. Then go to “Credentials” → “Create Credentials” → “OAuth client ID.” You’ll need to configure the consent screen first (set it to “External” for personal use, add your email as a test user). Create a “Desktop app” credential type and copy the Client ID and Client Secret.
First run of the MCP server will open a browser window for Google authentication. Approve the permissions and the server caches the credentials locally.
If you’re waiting for Google’s official remote MCP, that’s a reasonable choice. If you need Drive integration today, this server works once you get past the setup.
Config
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@isaacphi/mcp-gdrive"],
"env": {
"CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"CLIENT_SECRET": "your-client-secret"
}
}
}
}
Tested With
- Claude Desktop on Windows 11
{
"mcpServers": {
"google-drive-mcp": {
"command": "npx",
"args": [
"-y",
"@isaacphi/mcp-gdrive"
],
"env": {
"CLIENT_ID": "<YOUR_CLIENT_ID>",
"CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
}
}
}
} Environment Variables
CLIENT_ID(required) — OAuth Client ID from Google Cloud ConsoleCLIENT_SECRET(required) — OAuth Client Secret from Google Cloud ConsoleGDRIVE_CREDS_DIR— Directory to store OAuth credentials (optional)
Prerequisites
- Google Cloud Console project with Drive API enabled
- OAuth 2.0 credentials (Client ID + Secret)
- Node.js 18+
View on GitHub · npx -y @isaacphi/mcp-gdrive
Reviewed by J-Dub · February 22, 2026