Google Drive MCP Server

A server that provides MCP (Machine Control Protocol) interface to interact with Google Drive files and folders.

Features

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

Requirements

Python 3.12 or higher
Google Drive API credentials

Setup

Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install the package in editable mode:

pip install -e .

Set up Google Drive API credentials:
- Go to the Google Cloud Console
- Create a new project or select an existing one
- Enable the Google Drive API for your project
- Go to "Credentials" in the left sidebar
- Click "Create Credentials" and select "OAuth client ID"
- Choose "Desktop app" as the application type
- Download the credentials file and save it as credentials.json
Set up Google Drive authentication:

python -m gdrive_mcp_server.auth_setup --credentials /path/to/your/credentials.json --token /path/to/your/tokens.json

Usage

Run the server:

# Standard mode
gdrive-mcp

# HTTP mode
gdrive-mcp --http

Claude Desktop Integration

To integrate with Claude Desktop, add the following configuration to your claude_desktop_config.json:

"mcpServers": {
  "google_drive": {
    "command": "/path/to/your/venv/bin/gdrive-mcp",
    "args": [
      "--token",
      "/path/to/your/tokens.json"
    ]
  }
}

Replace the paths with your actual paths:

command: Path to the gdrive-mcp executable in your virtual environment
args[1]: Path to your tokens.json file (generated during authentication setup)

Development

The project uses:

Python 3.12+
Google Drive API
MCP server framework
FastMCP for HTTP transport
Rich for terminal formatting

Development dependencies can be installed with:

pip install -e ".[dev]"

License

MIT License