Skip to main content
Glama
Sign In
Google Drive MCP

Google Drive MCP

by EgCooper
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Google Drive MCP

Servidor MCP en Python para gestionar documentos de Google Drive (cuenta Gmail / Google Workspace) desde Cursor.

Tools

Tool

Descripción

list_files

Lista archivos/carpetas (raíz o por folder_id)

search_files

Busca por nombre en todo Drive

get_file_info

Metadatos y enlace web

download_file

Descarga texto o exporta Docs/Sheets/Slides

upload_text_file

Sube un archivo de texto

update_text_file

Actualiza contenido de un archivo

create_folder

Crea una carpeta

delete_file

Mueve a la papelera

Permiso por defecto: lectura y escritura (drive). Para solo lectura, cambia el scope en src/drive_mcp/auth.py a drive.readonly y elimina el token.json para volver a autorizar.

Related MCP server: manus-mcp

1. Google Cloud

  1. Abre Google Cloud Console.

  2. Crea un proyecto (o usa uno existente).

  3. Activa Google Drive API (APIs & Services → Library).

  4. Configura la pantalla de consentimiento OAuth (External o Internal).

  5. Crea credenciales: APIs & Services → Credentials → Create credentials → OAuth client ID.

    • Application type: Desktop app

  6. Descarga el JSON y guárdalo en la raíz del proyecto como credentials.json.

Si la app está en modo Testing, añade tu Gmail en Test users.

2. Instalación

cd MCP-PROJECT
python -m venv .venv
source .venv/bin/activate
pip install -e .

3. Primer login (opcional, recomendado)

python -c "from drive_mcp.auth import get_credentials; get_credentials()"

Se abre el navegador, autorizas con tu Gmail y se crea token.json.

4. Cursor (mcp.json)

{
  "mcpServers": {
    "google-drive": {
      "command": "/home/vpinto/Documents/Cooper/Repo2/MCP-PROJECT/.venv/bin/python",
      "args": ["-m", "drive_mcp.server"],
      "cwd": "/home/vpinto/Documents/Cooper/Repo2/MCP-PROJECT",
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/home/vpinto/Documents/Cooper/Repo2/MCP-PROJECT/credentials.json",
        "GOOGLE_TOKEN_PATH": "/home/vpinto/Documents/Cooper/Repo2/MCP-PROJECT/token.json"
      }
    }
  }
}

Ajusta las rutas si tu proyecto está en otra ubicación.

Variables de entorno

Variable

Descripción

GOOGLE_CREDENTIALS_PATH

Ruta a credentials.json (OAuth client)

GOOGLE_TOKEN_PATH

Ruta donde se guarda token.json

Notas

  • credentials.json y token.json no se suben a git.

  • La descarga por MCP está limitada a ~2 MiB y a contenido texto (o export de Docs).

  • El borrado envía a papelera; no elimina de forma permanente.

Available Tools

9 tools
create_folderA

Crea una carpeta en Google Drive.

Args: name: Nombre de la carpeta. parent_id: Carpeta padre. Vacío = raíz.

Inputs: name (required), parent_id. Returns: result

delete_fileA

Mueve un archivo o carpeta a la papelera de Google Drive.

Args: file_id: ID del elemento a eliminar.

Inputs: file_id (required). Returns: result

download_fileB

Descarga el contenido de un archivo de texto, o exporta Docs/Sheets/Slides.

Args: file_id: ID del archivo a descargar.

Inputs: file_id (required). Returns: result

get_file_infoA

Obtiene metadatos de un archivo o carpeta (nombre, tipo, enlace).

Args: file_id: ID del archivo en Google Drive.

Inputs: file_id (required). Returns: result

list_filesB

Lista archivos y carpetas en Google Drive.

Args: folder_id: ID de carpeta. Vacío = raíz (Mi unidad). page_size: Máximo de resultados (1-100). name_contains: Filtro opcional por nombre.

Inputs: folder_id, page_size, name_contains. Returns: result

move_fileA

Mueve un archivo o carpeta a otra carpeta.

Args: file_id: ID del archivo o carpeta a mover. folder_id: ID de la carpeta destino.

Inputs: file_id (required), folder_id (required). Returns: result

search_filesA

Busca archivos por nombre en todo Google Drive.

Args: query: Texto a buscar en el nombre. page_size: Máximo de resultados (1-100).

Inputs: query (required), page_size. Returns: result

update_text_fileA

Actualiza el contenido de un archivo de texto existente.

Args: file_id: ID del archivo a actualizar. content: Nuevo contenido.

Inputs: content (required), file_id (required). Returns: result

upload_text_fileA

Sube un archivo de texto nuevo a Google Drive.

Args: name: Nombre del archivo (ej. notas.txt). content: Contenido en texto. folder_id: Carpeta destino. Vacío = raíz.

Inputs: name (required), content (required), folder_id. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes (upload, update, download, move, delete, create folder). The only potential overlap is between list_files and search_files, but list_files is folder-scoped with optional filters while search_files is a global name search, which is a meaningful distinction.

    Naming Consistency5/5

    All tool names follow the same verb_noun pattern with consistent snake_case naming: list_files, search_files, get_file_info, download_file, upload_text_file, update_text_file, create_folder, move_file, delete_file. The convention is uniform across the entire set.

    Tool Count5/5

    With 9 tools, the set is well-scoped for a Google Drive server. Each tool addresses a core operation (list, search, get info, download, upload, update, create folder, move, delete) without unnecessary redundancy, striking a good balance between coverage and simplicity.

    Completeness4/5

    The toolset covers the essential file and folder lifecycle: create, read, update (content), delete, move, and search. Minor gaps exist such as no rename or copy tool, and no permission/sharing operations, but these are not critical for basic Drive management and can be worked around.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • manus-mcp

      mitjaeichhorn
      F
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that enables interaction with Google Drive through the Google Cloud API. It allows users to list, read, and upload files directly from MCP-compatible clients like manus.im or Cursor.
      -

    • google-drive-mcp

      domdomegg
      A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Google Drive that enables listing, searching, uploading, downloading, and managing files and folders, as well as handling comments and permissions.
      187 npm
      7
      MIT