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

Related MCP server: mcp-google-gdrive

Requirements

• Python 3.12 or higher

• Google Drive API credentials

Setup

1. Create a virtual environment:

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

2. Install the package in editable mode:

pip install -e .

3. 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

4. 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