Google Drive MCP Server

Name: Google Drive MCP Server
Author: hxie-pallas

@hxie-pallas

Repository

About Google Drive MCP Server

A google drive mcp servers based on Python

#gdrive #mcp #google-drive #python

Basic information

Config

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

{
  "mcpServers": {
    "gdrive-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Drive MCP Server?

A server that provides an MCP (Model Context Protocol) interface to interact with Google Drive files and folders. It supports searching files, retrieving file content and metadata, and uses OAuth authentication with token persistence. Designed for developers integrating Google Drive into MCP-compatible AI assistants and clients.

How to use Google Drive MCP Server?

Install the package after creating a Python 3.12+ virtual environment. Obtain Google Drive API credentials (OAuth client ID for Desktop app) from the Google Cloud Console and save as credentials.json. Run the authentication setup script (python -m gdrive_mcp_server.auth_setup --credentials /path/to/credentials.json --token /path/to/tokens.json) to generate a token file. Then start the server with gdrive-mcp (stdio mode) or gdrive-mcp --http (HTTP mode). For Claude Desktop integration, add the command and token path to claude_desktop_config.json.

Key features of Google Drive MCP Server

Search for files in Google Drive
Get file content and metadata
OAuth authentication with token persistence
HTTP and stdio transport modes
Python 3.12+ support

Use cases of Google Drive MCP Server

Integrate Google Drive file search into AI assistants
Retrieve file contents for processing or summarization
Automate document metadata extraction
Build custom MCP clients with Drive access

FAQ from Google Drive MCP Server

What are the runtime requirements?

Python 3.12 or higher and valid Google Drive API credentials (OAuth client ID for Desktop app).

How does authentication work?

Uses OAuth with token persistence. You run the auth_setup script with your downloaded credentials.json to generate a tokens.json file that authenticates future sessions.

What transport modes are available?

Two modes: stdio (default) and HTTP (using the --http flag). stdio is used for local integration; HTTP enables remote or web‑based MCP clients.

Where are user tokens stored?

In a tokens.json file specified during the authentication setup. The path is provided via the --token argument and reused when starting the server.

How do I integrate this server with Claude Desktop?

Add an entry to the mcpServers section of claude_desktop_config.json, setting the command to the full path of the gdrive-mcp executable and the args to include --token and the path to your tokens.json file.