Servidor MCP de Google Drive

Servidor MCP local en Python para leer/escribir Google Sheets, Slides y Drive desde sesiones de Claude Code.

Cómo funciona

El servidor usa OAuth 2.0 Desktop App de GCP. En el primer uso, abre el navegador para el flujo de consentimiento. Una vez aprobado, guarda un token.json local. En las siguientes ejecuciones, reutiliza el token y lo renueva automáticamente cuando expira — sin necesidad de abrir el navegador de nuevo.

Archivos de autenticación:

Related MCP server: google-workspace-mcp-with-script

Configuración inicial (primera vez)

1. Credenciales GCP

1. Accede a GCP Console → APIs & Services → Credentials

2. Crea un OAuth 2.0 Client ID (tipo: Desktop App)

3. Descarga el JSON y guárdalo como credentials.json en esta carpeta

4. Habilita las APIs en el proyecto de GCP:

   • Google Sheets API

   • Google Slides API

   • Google Drive API

2. Instalar dependencias

Windows (PowerShell):

cd "C:\Users\<usuario>\Documents\MCP_Servers\googleDrive"
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

macOS / Linux:

cd ~/Documents/MCP_Servers/googleDrive
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Primer inicio de sesión (OAuth)

Ejecuta manualmente para abrir el navegador y autorizar:

Windows:

.venv\Scripts\activate
python main.py

macOS / Linux:

source .venv/bin/activate
python main.py

Tras aprobar en el navegador, se crea token.json y el servidor arranca. Puedes cerrar con Ctrl+C — el token se guarda para las próximas ejecuciones.

Registrar en Claude Code

Hay dos formas de registrar el servidor MCP:

Opción A — Por proyecto (.mcp.json)

Crea un archivo .mcp.json en la raíz del proyecto. El MCP queda activo solo en ese proyecto.

Windows:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\main.py"
      ]
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "/Users/<usuario>/Documents/MCP_Servers/googleDrive/.venv/bin/python",
      "args": [
        "/Users/<usuario>/Documents/MCP_Servers/googleDrive/main.py"
      ]
    }
  }
}

Opción B — Global para el usuario (~/.claude/settings.json)

Añade el MCP en la configuración global de Claude Code — queda disponible en todos los proyectos.

Edita ~/.claude/settings.json (Windows: C:\Users\<usuario>\.claude\settings.json) y añade la clave mcpServers:

Windows:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\main.py"
      ]
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "/Users/<usuario>/Documents/MCP_Servers/googleDrive/.venv/bin/python",
      "args": [
        "/Users/<usuario>/Documents/MCP_Servers/googleDrive/main.py"
      ]
    }
  }
}

Usa la Opción A cuando el MCP sea específico de un proyecto. Usa la Opción B cuando quieras acceso en cualquier proyecto.

Variables de entorno (opcional)

Por defecto, el servidor busca credentials.json y token.json en su propia carpeta. Para cambiar las rutas, crea un .env basado en el .env.example:

GOOGLE_CREDENTIALS_PATH=credentials.json
GOOGLE_TOKEN_PATH=token.json

Herramientas disponibles (17 tools)

Google Sheets (7)

Google Slides (7)

Google Drive (3)

Todos los tools aceptan ID directo o URL completa de Google:

• 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms

• https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms/edit

Troubleshooting

invalid_grant / token expirado sin auto-renovación

Borra el token.json y ejecuta python main.py de nuevo para rehacer el flujo OAuth.

Windows:

Remove-Item ".\token.json"
python main.py

macOS / Linux:

rm token.json
python main.py

API no habilitada

Comprueba que las tres APIs estén activas en GCP Console: Google Sheets API, Google Slides API, Google Drive API.

MCP no aparece en Claude Code

Comprueba que la ruta del ejecutable de Python sea correcta:

• Windows: .venv\Scripts\python.exe

• macOS/Linux: .venv/bin/python

Usa la ruta absoluta en el .mcp.json o `settings.json — las rutas relativas no funcionan.