Google Drive server

Name: Google Drive server
Author: ejoyee

@ejoyee

Repository

About Google Drive server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ej-mcp-server-gdrive": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount",
        "type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json",
        "-v",
        "mcp-gdrive:/gdrive-server",
        "-e",
        "GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json",
        "-e",
        "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
        "-p",
        "3000:3000",
        "mcp/gdrive",
        "auth"
      ]
    }
  }
}

Tools

Search for files in Google Drive

Overview

What is Google Drive server?

Google Drive server is a Model Context Protocol (MCP) server that integrates with Google Drive to allow listing, reading, and searching files. It supports all file types and automatically exports Google Workspace files (Docs, Sheets, Presentations, Drawings) to standard formats.

How to use Google Drive server?

Set up a Google Cloud project, enable the Drive API, configure OAuth consent, create an OAuth client ID for a desktop app, and place the key file as gcp-oauth.keys.json in the project root. Build with npm run build or npm run watch. Authenticate by running node ./dist auth and completing the browser flow. Then configure the server in your MCP client—supports NPX (@modelcontextprotocol/server-gdrive) or Docker (mcp/gdrive).

Key features of Google Drive server

Search for files in Google Drive by query.
Access files via URI scheme gdrive:///<file_id>.
Automatic export of Google Docs to Markdown.
Automatic export of Google Sheets to CSV.
Automatic export of Presentations to plain text.
Automatic export of Drawings to PNG.

Use cases of Google Drive server

Search and retrieve documents for analysis by an AI assistant.
Read Google Drive files in their native or exported format.
Integrate file discovery into automated workflows.
Access Drive content from within a VS Code environment.

FAQ from Google Drive server

How do I authenticate Google Drive server?

Run the server with the auth argument: node ./dist auth. This opens an authentication flow in your system browser. Credentials are saved to servers/.gdrive-server-credentials.json.

What file formats are supported?

All Google Workspace files are automatically exported: Docs → Markdown, Sheets → CSV, Presentations → plain text, Drawings → PNG. Other file types are provided in their native format.

What are the runtime requirements?

Node.js is required to build and run the server. Alternatively, Docker can be used for containerized deployment. Google Cloud project with Drive API enabled and OAuth 2.0 credentials are mandatory.

How do I configure Google Drive server with VS Code?

Add a JSON block to User Settings or .vscode/mcp.json. For NPX, set the command to npx -y @modelcontextprotocol/server-gdrive with environment variable GDRIVE_CREDENTIALS_PATH. For Docker, use the mcp/gdrive image with the mcp-gdrive volume and GDRIVE_CREDENTIALS_PATH environment variable.

Where are credentials stored after authentication?

Credentials are saved in the file servers/.gdrive-server-credentials.json after running the auth flow. This path can be overridden via the environment variable GDRIVE_CREDENTIALS_PATH.