Skip to main content
Glama
Sejin-Koo

google-workspace-mcp

by Sejin-Koo

google-workspace-mcp

MCP-сервер для работы с Google Workspace (Sheets / Docs / Slides / Forms) и Google Drive.

Официальный коннектор «Google Drive», подключённый к Cowork по умолчанию, поддерживает только поиск, чтение, создание файлов и перемещение в корзину — он не может изменять содержимое существующих файлов. Поэтому, чтобы добавить хотя бы одну строку в таблицу, приходилось пересоздавать весь файл и выбрасывать старый. Этот сервер заполняет этот пробел — он добавляет строки в таблицу, сохраняя ID файла, правит текст документа и добавляет слайды.

Предоставляемые инструменты

Инструмент

Что делает

sheets_values

Чтение значений ячеек / append (добавление строк) / update / clear

sheets_manage

Создание таблиц, добавление, удаление и переименование вкладок, просмотр метаданных, batchUpdate

docs_read

Чтение документа как текста (включая таблицы) или в исходной структуре

docs_write

Создание документа, добавление в конец, вставка в позицию, поиск и замена, batchUpdate

slides_read

Просмотр текста и заметок докладчика по слайдам

slides_write

Создание презентации, добавление слайдов (с заполнением заголовка и текста), удаление, поиск и замена

forms_tool

Создание и просмотр форм, просмотр списка и отдельных ответов, batchUpdate

drive_search

Поиск по имени файла, полнотекстовый поиск по содержимому, MIME, условиям папки

drive_file

Метаданные, создание, создание папок, замена содержимого (с сохранением ID), переименование, перемещение, копирование, корзина, полное удаление, скачивание, export

drive_comments

Просмотр, создание, ответы, решение и удаление комментариев

drive_revisions

Просмотр истории версий, получение содержимого прошлых версий, закрепление версии

drive_permissions

Проверка, добавление, изменение и снятие прав доступа

drive_shared_drives

Список и подробности общих дисков

drive_changes

Получение стартового токена и просмотр только изменений после него

Все инструменты позволяют ограничить длину ответа параметром max_chars; значение 0 означает без обрезки.

Related MCP server: Google Docs, Drive & Sheets MCP Server

Переменные окружения

Имя

Описание

GOOGLE_CLIENT_ID

ID OAuth-клиента

GOOGLE_CLIENT_SECRET

Секрет OAuth-клиента

GOOGLE_REFRESH_TOKEN

Refresh-токен, включающий scope https://www.googleapis.com/auth/drive

MCP_GATE_KEYS

Список разрешённых ключей доступа (через запятую). Если пусто — шлюз отключён

MCP_GATE_MODE

При enforce вызовы без ключа блокируются с кодом 401

Одного scope drive достаточно, чтобы покрыть API Sheets, Docs, Slides, Forms и весь Drive API (в официальных списках scope для аутентификации каждого API присутствует auth/drive).

Подготовка проекта Google Cloud

Помимо scope, необходимо включить (Enable) используемые API в проекте. Если они не включены, возникнет ошибка 403 has not been used in project ... or it is disabled.

  • Google Sheets API / Google Docs API / Google Slides API / Google Forms API

  • Google Drive API

Вызов

https://<배포도메인>/api/mcp?k=<게이트키>

Локальный смоук-тест

Поместите три указанных выше учётных данных Google в scripts/.env.local.json (в gitignore) и выполните:

npm install
npm test

Тест создаёт файлы в реальном аккаунте Google, а в конце перемещает их в корзину.

Related MCP Connectors

Related MCP Servers