mcp-google-gdrive

MCP-сервер для Google Диска, Документов, Таблиц и Презентаций. Позволяет ИИ-ассистентам управлять файлами, папками, разрешениями, метками и корзиной с полным доступом на чтение/запись для нескольких аккаунтов Google. Включает автоматическое преобразование форматов Workspace (Документы в Markdown, Таблицы в CSV/JSON, Презентации в текст).

Инструменты

Управление аккаунтами

Файлы

Папки

Корзина

Разрешения

Метки

Google Документы

Google Таблицы

Google Презентации

Что нового в версии 2.2

• Параметр outputFormat — 12 инструментов чтения/списка теперь принимают outputFormat: "json" | "yaml" | "text". По умолчанию используется json (обратная совместимость). Используйте yaml для структурированного вывода или text для компактных таблиц, удобных для чтения. Поддерживается в: list_accounts, list_files, list_folder, list_trash, list_permissions, list_labels, list_file_labels, list_sheets, get_metadata, read_sheet_range, get_slide_thumbnail, search_files.

v2.1

• gdrive_download_file — Скачивание любого файла с Диска на локальный путь. Файлы Workspace (Документы, Таблицы, Презентации) автоматически экспортируются в указанный формат (pdf, docx, xlsx, pptx, csv, txt, html или markdown).

• savePath в инструментах экспорта — gdrive_export_doc, gdrive_export_sheet и gdrive_export_slides теперь принимают необязательный параметр savePath. Если он указан, бинарные файлы (docx, pdf, xlsx, pptx) сохраняются на диск, а не возвращаются в формате base64. Пропуск savePath сохраняет поведение версии 2.0.

• Разрешение email в gdrive_list_accounts — Аккаунты, перенесенные из версии 0.x, где вместо email отображалось "migrated", теперь автоматически разрешаются через API Google userinfo при первом вызове.

• Исправления документации — gdrive_empty_trash отмечает конечное согласование (eventual consistency); gdrive_transfer_ownership отмечает ограничения между организациями.

Форматы вывода

Все инструменты чтения и списка поддерживают параметр outputFormat:

Пример: gdrive_list_files({ query: "name contains 'report'", outputFormat: "text" }) возвращает:

files:
  id             name              mimeType         modifiedTime  size
  -------------  ----------------  ---------------  ------------  ----
  abc123def456   Q1 Report.pdf     application/pdf  2026-04-01    1024
  ghi789jkl012   Q2 Report.docx    application/pdf  2026-03-15    2048
resultCount: 2

Предварительные требования

• Node.js 18+

• Проект в Google Cloud с включенными API:

  • Google Drive API

  • Google Docs API

  • Google Sheets API

  • Google Slides API

• Учетные данные OAuth2 для настольного приложения

Настройка

1. Создайте проект в Google Cloud Console и включите API Диска, Документов, Таблиц и Презентаций

2. Создайте учетные данные OAuth2 (тип приложения: Desktop app) и скачайте JSON-файл

3. Сохраните файл учетных данных:

mkdir -p ~/.config/mcp-google-gdrive
cp ~/Downloads/client_secret_*.json ~/.config/mcp-google-gdrive/credentials.json
chmod 600 ~/.config/mcp-google-gdrive/credentials.json

4. Запустите однократный процесс авторизации:

npx mcp-google-gdrive --auth primary

Это выведет URL для согласия Google. После предоставления доступа вставьте код авторизации обратно в терминал.

Настройка нескольких аккаунтов

Добавляйте дополнительные аккаунты с уникальными метками:

npx mcp-google-gdrive --auth work
npx mcp-google-gdrive --auth personal

Каждый аккаунт получает свой файл токена в ~/.config/mcp-google-gdrive/tokens/{label}.json. Используйте параметр account в любом инструменте, чтобы указать, какой аккаунт использовать, или вызовите gdrive_switch_account для изменения аккаунта по умолчанию.

Конфигурация

Gemini CLI

Добавьте в ~/.gemini/settings.json:

{
  "mcpServers": {
    "google-gdrive": {
      "command": "npx",
      "args": ["-y", "mcp-google-gdrive"]
    }
  }
}

watsonx Orchestrate

orchestrate toolkits import --kind mcp \
  --name google-gdrive \
  --description "Google Drive, Docs, Sheets, Slides" \
  --command "npx -y mcp-google-gdrive" \
  --tools "*"

Claude Code

claude mcp add -s user google-gdrive -- npx -y mcp-google-gdrive

VS Code / Cursor

Добавьте в .vscode/mcp.json в вашей рабочей области:

{
  "mcpServers": {
    "google-gdrive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-gdrive"]
    }
  }
}

Аутентификация

Сервер использует OAuth2 для доступа к Google Диску. Учетные данные хранятся локально:

• ~/.config/mcp-google-gdrive/credentials.json — клиент OAuth2 (общий для всех аккаунтов)

• ~/.config/mcp-google-gdrive/tokens/{label}.json — токены для каждого аккаунта (chmod 600)

• ~/.config/mcp-google-gdrive/config.json — активный аккаунт и реестр аккаунтов

Токены доступа истекают через час и автоматически обновляются с использованием сохраненных токенов обновления. Обновление токена происходит прозрачно и не требует участия пользователя.

Миграция с версии 0.x

При обновлении с установки версии 0.x с одним аккаунтом сервер автоматически переносит ваш существующий token.json в tokens/primary.json при первом запуске.

Связанные MCP-серверы

• mcp-redhat-account - Управление аккаунтом Red Hat

• mcp-redhat-knowledge - Поиск по базе знаний Red Hat

• mcp-redhat-manpage - Man-страницы RHEL

• mcp-redhat-subscription - Управление подписками

• mcp-redhat-support - Управление обращениями в поддержку

Лицензия

MIT