Google Workspace MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

12 сервисов в одном сервере: Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search
Уровни инструментов (core / extended / complete) сохраняют список инструментов управляемым
OAuth 2.0 + 2.1 с multi-user bearer-token режимом для hosted-развёртываний
Stateless-режим для Docker / Kubernetes
Зашифрованный локальный кэш токенов; опциональное хранение учётных данных в GCS

Живое демо

Как выглядит на практике

google-workspace-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "google-workspace-mcp",
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "google-workspace-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "workspace-mcp",
          "--tool-tier",
          "core"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add google-workspace-mcp -- uvx workspace-mcp --tool-tier core

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Google Workspace MCP

Разбор входящих Gmail до нуля с Claude в роли помощника

👤 Все, у кого больше 200 непрочитанных писем ⏱ ~25 min beginner

Когда использовать: Понедельное утро, а входящие — сплошная стена.

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

OAuth-клиент Google Cloud — Создайте учётные данные OAuth 2.0 в console.cloud.google.com, скачайте client_secret.json
Установленный сервер — uvx workspace-mcp --tool-tier core (первый вызов открывает браузер для OAuth)

Поток

Разбить входящие по категориям

Use google-workspace-mcp. List unread mail from the last 7 days. Bucket into: action-required, FYI, newsletters, automated.✓ Скопировано

→ Количество по категориям и примеры тем
Автоматически архивировать малоценные категории

Archive everything in newsletters + automated. Don't touch action-required.✓ Скопировано

→ N заархивировано, action-required не затронуты
Составить черновики ответов

For each action-required email, draft a 2-line reply in my voice. Save as drafts, don't send.✓ Скопировано

→ Черновики видны в Gmail; вы правите и отправляете

Итог: Входящие сокращены до <20, ответы готовы в черновиках — окончательное решение остаётся за вами.

Подводные камни

Выдали полный scope Gmail и теперь жалеете — Используйте --tool-tier core — инструмент send_email недоступен, пока не перейдёте на extended

Сочетать с: filesystem

Еженедельный статус-отчёт из Calendar и активности в Docs

👤 Разработчики и менеджеры, пишущие еженедельные апдейты ⏱ ~10 min beginner

Когда использовать: Пятница, вы забыли, что делали всю неделю.

Поток

Получить данные из календаря

Use google-workspace-mcp. List meetings I attended Mon–Fri this week (skip declined). For each, give 1-line context.✓ Скопировано

→ Хронологический список с кратким описанием каждой встречи
Получить активность в документах

List Drive docs I edited or commented on this week. Group by project.✓ Скопировано

→ Сгруппированный список документов с количеством правок и комментариев
Составить апдейт

Combine into a 6-bullet weekly update — what I shipped, what's blocked, what's next.✓ Скопировано

→ Черновик, готовый к отправке в Slack или по почте

Итог: Еженедельный апдейт за 3 минуты вместо 30, основанный на реальных артефактах.

Подводные камни

Регулярные встречи 1:1 засоряют отчёт — Фильтруйте по шаблонам названий встреч или количеству участников — попросите Claude по умолчанию пропускать регулярные 1:1

Извлечение структурированных данных из неструктурированных таблиц с записью результатов

👤 Операционные отделы, финансы, все, кто живёт в таблицах ⏱ ~20 min intermediate

Когда использовать: Есть таблица с 1000 строк произвольных описаний, которые нужно категоризировать.

Поток

Прочитать диапазон

Use google-workspace-mcp. Read column B from Sheet 'Q4 expenses' — 1000 rows of vendor descriptions.✓ Скопировано

→ Строки загружены; показан пример
Категоризировать

Categorize each row into: SaaS, hardware, travel, services, other. Show distribution first.✓ Скопировано

→ Таблица распределения; примеры для проверки
Записать результаты

Write categories into column F. Add a header. Don't touch other columns.✓ Скопировано

→ Таблица обновлена; вы проверяете несколько ячеек вручную

Итог: Категоризированные данные в таблице, история в чате.

Подводные камни

Claude перезаписывает нужный столбец — Всегда явно указывайте целевой столбец; перед массовой записью проверьте несколько ячеек

Автоматическая подготовка документов к встречам из приглашений в Calendar

👤 Все, у кого встречи идут одна за другой ⏱ ~15 min intermediate

Когда использовать: Завтра 5 встреч, а контекст к ним нулевой.

Поток

Просмотреть завтрашний день

Use google-workspace-mcp. List tomorrow's meetings with attendees and any attached docs.✓ Скопировано

→ Блок по каждой встрече с участниками и связанными документами
Сформировать брифинги

For each, create a Doc 'Prep — <meeting title>' summarizing attached docs + suggesting 3 questions to ask.✓ Скопировано

→ N документов создано в папке /Meeting prep/

Итог: Входить на каждую встречу подготовленным, а не импровизировать.

Подводные камни

Внешние участники не видят ваш подготовительный документ, но чувствительное название в заголовке может выдать намерения — Используйте приватную папку; называйте 'Prep — <тема>', а не '<конфиденциальное название сделки>'

Комбинации

Сочетайте с другими MCP — эффект x10

google-workspace-mcp + filesystem

Синхронизация документов Drive на локальный диск для офлайн-редактирования или git-трекинга

Pull all docs in /weekly-updates/ from Drive into ./drive-mirror/ as markdown.✓ Скопировано

google-workspace-mcp + github

Зеркалирование заметок о релизах между GitHub и документом

Take the latest GitHub release notes and append them to the 'Release log' Google Doc.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
search_gmail	query: str (Gmail search syntax), max_results?	Поиск писем по критериям на естественном языке	1 Gmail API call
send_email	to, subject, body, cc?, bcc?	Только в уровне extended/complete — никогда не отправлять автоматически без подтверждения	1 API call
list_calendar_events	calendar_id, time_min, time_max	Получить события за диапазон дат	1 Calendar API call
read_sheet_range	spreadsheet_id, range (A1 notation)	Получить ячейки из таблицы	1 Sheets API call
write_sheet_values	spreadsheet_id, range, values[][]	Обновить диапазоны таблицы вычисленными данными	1 API call
create_doc	title, content (markdown)	Создать новые документы из вывода чата	1 Docs API call
search_drive	query, mime_type?	Найти файлы по имени или содержимому	1 Drive API call

Стоимость и лимиты

Во что обходится

Квота API: Gmail: 250 quota units/user/sec; Calendar: 500 req/100sec; Sheets: 300 req/min/user
Токенов на вызов: 200–4000 в зависимости от вызова (полное тело письма vs метаданные)
Деньги: Бесплатно для персональных аккаунтов Google; в организациях Workspace могут быть ограничения администратора
Совет: Используйте --tool-tier core, если не нужны Forms/Slides/Apps Script — меньше инструментов = короче системный prompt

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: gmail.readonly calendar.readonly drive.readonly

Хранение учётных данных: Зашифрованный локальный кэш токенов по умолчанию; опционально — хранение в GCS для hosted-режима

Исходящий трафик: Напрямую на googleapis.com — без сторонних ретрансляторов

Никогда не давайте: gmail.send (пока не понимаете риски авто-отправки) drive (полный read/write везде)

Поддерживаются OAuth 2.0 + 2.1; используйте PKCE public client, если нет confidential client setup

Устранение неполадок

Частые ошибки и исправления

OAuth callback не работает / браузер не открывается

Установите OAUTH_REDIRECT_PORT на свободный порт и перезапустите; на headless-машинах используйте device-flow режим

Проверить: lsof -i :8080 для проверки свободности порта

403 insufficient_permissions

Повторно авторизуйтесь с недостающим scope; убедитесь, что ваш OAuth-клиент разрешён в Google Cloud Console

Проверить:

Декодируйте токен на oauth2.googleapis.com/tokeninfo, чтобы увидеть выданные scopes

Администратор Workspace блокирует OAuth-клиент

Попросите администратора добавить ваш client ID в список доверенных приложений, или используйте личный аккаунт Google для тестов

Превышена квота при массовых операциях

Добавьте backoff; сервер соблюдает заголовки Retry-After, но массовые циклы всё равно могут превысить посекундные лимиты

Проверить: Следите за HTTP 429 в логах

Альтернативы

Google Workspace MCP в сравнении

Альтернатива	Когда использовать	Компромисс
Pipedream MCP	Нужен managed OAuth и готовые интеграции Google без самостоятельного хостинга	Платно при масштабировании; данные проходят через Pipedream
Per-service MCP servers (gmail-mcp, drive-mcp)	Нужен только один сервис Google и минимальный scope	Несколько OAuth-потоков и кэшей токенов для управления

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills