A server that provides MCP (Machine Control Protocol) interface to interact with Google Drive files and folders.
- Search for files in Google Drive
- Get file content and metadata
- OAuth authentication with token persistence
- HTTP and stdio transport modes
- Python 3.12 or higher
- Google Drive API credentials
- 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.jsonRun the server:
# Standard mode
gdrive-mcp
# HTTP mode
gdrive-mcp --httpTo 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 environmentargs[1]: Path to your tokens.json file (generated during authentication setup)
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]"MIT License