Skip to content
Menu

MCP server / files & storage / source-linked

Google Drive MCP

This entry is useful as a historical reference for a local Drive reader: it searches files and exports Google Workspace documents into model-readable formats. It is not a current Google-hosted Drive MCP and should not be presented as actively maintained production infrastructure.

Before you choose.

Identify the implementation and the job it supports.

Which implementation is this?
The Model Context Protocol Google Drive server is an archived reference implementation, maintained in the servers-archived repository.
Implementation source ↗

This entry is useful as a historical reference for a local Drive reader: it searches files and exports Google Workspace documents into model-readable formats. It is not a current Google-hosted Drive MCP and should not be presented as actively maintained production infrastructure.

Setup and connection.

The documented interface, authentication and installation path.

Connection / transport
stdio (archived local server)
Authentication
Google Cloud OAuth desktop client with drive.readonly scope

Create a Drive API project and OAuth desktop client, place `gcp-oauth.keys.json` in the repository, build, then run `node ./dist auth`. The documented NPX configuration uses `@modelcontextprotocol/server-gdrive` and a credentials path.

Setup reference ↗

Documented setup example. Review the source and credentials before running; this command was not executed for this article.

{"mcpServers":{"gdrive":{"command":"npx","args":["-y","@modelcontextprotocol/server-gdrive"],"env":{"GDRIVE_CREDENTIALS_PATH":"/path/to/.gdrive-server-credentials.json"}}}}

What it actually exposes.

Concrete capabilities with maintainer sources.

Documented capability / 01

Search Drive files

The search tool accepts a query and returns matching names and MIME types.

Documentation ↗
Documented capability / 02

Read exported Workspace files

Resources expose Drive files; Docs export as Markdown, Sheets as CSV, Presentations as plain text and Drawings as PNG.

Documentation ↗
Documented capability / 03

Use local client configuration

The reference documents NPX, Docker and VS Code configuration blocks for stdio clients.

Documentation ↗

Evidence and method.

What was checked and what was not tested.

WHO

Editorial record

Compiled by clawbot.ai.

HOW

Source method

Public maintainer documentation and repositories. This is not a hands-on product review.

WHEN

Last checked 2026-10-01

Setup examples are documented examples. Suggested trials and comparison advice are editorial guidance.

Sources support the adjacent factual statements. A source review does not establish uptime, performance, security or current account eligibility. Read the editorial policy.

Community signals.

Concrete reports from public community discussions, kept separate from product documentation.

Reddit r/ClaudeAI / setup / mixed / discussion2026-03-20 · papaleguas67 (comment)

Does anyone have a problem to connect Google Drive to Claude Cowork?

用户报告 Drive 连接状态显示已连接,但 Cowork 对话中没有启用。重新发起一次连接搜索并完成授权后恢复;设置页没有明显的 Reconnect 入口,只能通过对话界面触发。另有用户仍遇到临时不可用和 Sheets 无法识别,说明连接恢复路径不够可发现。

“Hit reconnect, went thru the authorization again, and bingo, working fine.”
Open community source ↗
Reddit r/ClaudeAI / reliability / negative / firsthand2026-05-16 · 匿名 Reddit 用户

Google Drive MCP connector returning generic errors on every query

用户在 MAX 计划上连续五天遇到查询立即失败:OAuth 完成、连接页面显示成功,但每个搜索都返回泛化错误。用户已断开重连 Google 与 Claude、删除账户连接、重启、无痕模式并启用内置 Node,仍未解决,Anthropic 支持也没有给出修复。

“The connector shows as successfully connected, but every query fails instantly with no specific error message.”
Open community source ↗
GitHub issue (Hermes Agent) / permissions / negative / issue2026-05-29 · vrosu; teknium1

Official MCP server for Google Drive authenticates successfully, then always times out

Hermes 用户在 Ubuntu 24.04、Hermes 0.15.1 中配置 Google 官方 Drive MCP。登录命令因未认证的 tools/list 误报成功,随后所有实际工具调用超时。维护者定位为动态客户端注册不兼容,并合并修复:登录后检查令牌是否真正写入,必要时要求预注册 OAuth client。

“hermes mcp login saw the tool list and reported Authenticated even though the OAuth flow never completed.”
Open community source ↗

Community evidence is anecdotal and may reflect one setup, version or account. It is included for discovery and risk-sensing, not as a representative rating or independent benchmark. Verify the current official documentation before acting on a report.

Try a specific task.

A bounded evaluation you can reproduce in your own environment.

Proposed workflow: recover a source document

Suggested evaluation, not an observed test result.

  1. Authorize a test account with read-only Drive scope and select a non-sensitive folder.
  2. Search for a document by title or query and inspect its exported resource.
  3. Cite the original Drive file and verify formatting before using the extracted text.

What to inspect: A locally retrievable document trail; no connection or extraction test was run here.

Workflow reference ↗

Permissions and limitations.

Read these constraints before granting access.

Boundary / 01

The reference server is archived and no longer actively maintained; current Drive users should evaluate a maintained Workspace integration.

Boundary reference ↗
Boundary / 02

The archived implementation lacks Shared Drive parameters in several operations, so its coverage is not equivalent to all Drive content.

Boundary reference ↗

Decide by workflow.

Make the expected output explicit before you connect.

A locally retrievable document trail; no connection or extraction test was run here.

Keep the task inputs, tool calls, output and any errors together when you evaluate. The trial above is a proposal, not a recorded result.

Compare the alternatives.

Specific reasons to choose another route, with the tradeoff shown.

Editorial decision guidance inferred from the linked documentation; no quality or speed benchmark.
AlternativeChoose it whenTradeoff
Google Workspace CLI MCPEditorial choice: you need Drive plus Gmail, Calendar, Sheets and Docs from a maintained CLI.Current gws releases removed the MCP subcommand; use its CLI/skills mode or another MCP wrapper.
Documentation ↗
Notion MCPEditorial choice: the source of truth has already moved into Notion.It cannot access Drive files unless they are connected or migrated.
Documentation ↗

Questions before setup.

Answers specific to this implementation.

Is this the official Google Drive MCP service?

No. It is an archived reference server in the MCP servers-archived repository.
Documentation ↗

Does it support Shared Drives?

Do not assume so. The archived implementation has a documented lack of Shared Drive parameters.
Documentation ↗