GdriveSAFE
Efficient implementation of the Google Drive MCP server
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
A powerful Model Context Protocol (MCP) server that provides seamless integration with Google Drive, allowing AI models to search, list, and read files from Google Drive.
🚀 Features
Tools
1. gdrive_search
Search for files in your Google Drive with powerful full-text search capabilities.
- Input:
{
"query": "string (your search query)"
}- Output: List of files with:
- File name
- MIME type
- File ID
- Last modified time
- File size
2. gdrive_read_file
Read file contents directly using a Google Drive file ID.
- Input:
{
"file_id": "string (Google Drive file ID)"
}- Output: File contents with appropriate format conversion
Automatic File Format Handling
The server intelligently handles different Google Workspace file types:
- 📝 Google Docs → Markdown
- 📊 Google Sheets → CSV
- 📊 Google Presentations → Plain text
- 🎨 Google Drawings → PNG
- 📄 Text/JSON files → UTF-8 text
- 📦 Other files → Base64 encoded
🛠️ Getting Started
Prerequisites
- Node.js (v16 or higher)
- npm or yarn
- A Google Cloud Project
- A Google Workspace or personal Google account
Detailed Google Cloud Setup
- Create a Google Cloud Project
- Visit the Google Cloud Console
- Click "New Project"
- Enter a project name (e.g., "MCP GDrive Server")
- Click "Create"
- Wait for the project to be created and select it
- Enable the Google Drive API
- Go to the API Library
- Search for "Google Drive API"
- Click on "Google Drive API"
- Click "Enable"
- Wait for the API to be enabled
- Configure OAuth Consent Screen
- Navigate to OAuth consent screen
- Select User Type:
- "Internal" if you're using Google Workspace
- "External" for personal Google acc
d63ff7d5d790OBSERVED · 2026-10-07Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add server-gdrive --env GOOGLE_APPLICATION_CREDENTIALS=${GOOGLE_APPLICATION_CREDENTIALS} --env MCP_GDRIVE_CREDENTIALS=${MCP_GDRIVE_CREDENTIALS} -- npx -y @modelcontextprotocol/[email protected]{
"mcpServers": {
"server-gdrive": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/[email protected]"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "${GOOGLE_APPLICATION_CREDENTIALS}",
"MCP_GDRIVE_CREDENTIALS": "${MCP_GDRIVE_CREDENTIALS}"
}
}
}
}Exposed tools (2)
2 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
gdrive_read_file | read | Read a file from Google Drive using its Google Drive file ID (don |
gdrive_search | read | Search for files specifically in your Google Drive account (don |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (1)
@google-cloud/local-auth, @modelcontextprotocol/sdk, googleapis, @types/node, shx, typescript
Gates applied: no_behavioural_pass.
d63ff7d5d790full audit observations/trust-audit/mcp-server/felores__gdrive.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-07 | d63ff7d5d790 | SAFE | B | 89 | first audit |
Questions
What is the Gdrive MCP server?
Efficient implementation of the Google Drive MCP server
What tools does Gdrive expose?
2 in total: 2 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Gdrive safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does Gdrive need?
It reads GOOGLE_APPLICATION_CREDENTIALS and MCP_GDRIVE_CREDENTIALS from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Gdrive run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as @modelcontextprotocol/server-gdrive at 0.6.2.
How current is this page?
The grade is for one exact copy of the source (d63ff7d5d790), read on 2026-10-07. The repository is watched and re-audited when it changes.