google-suite-mcp

У вас есть ИИ, который умеет думать. Теперь дайте ему руки.

Сервер Google Workspace MCP с открытым исходным кодом, который предоставляет Claude Desktop, Cursor, Windsurf, Zed, VS Code (GitHub Copilot), Gemini CLI и любому другому клиенту протокола Model Context Protocol полный контроль чтения/записи над Google Таблицами, Документами, Диском и Apps Script. 82 инструмента. Один сервер. Лицензия MIT.

google-suite-mcp — это первый оператор рабочего пространства (Workspace Operator): единственный MCP, который рассматривает Google Workspace как среду выполнения, которой может управлять ИИ. Он создает дашборды, развертывает скрипты Apps Script и форматирует документы одним вызовом, вместо того чтобы просто предоставлять Workspace как поверхность для чтения.

Десятиминутная настройка OAuth — это все, что требуется для начала. После этого один запрос на естественном языке может создать многоячеечный KPI-дашборд (sheets_build_dashboard), превратить схему в полностью отформатированную таблицу (sheets_build_sheet) или опубликовать Google Apps Script как веб-приложение (script_deploy). Это три составных примитива, которые не предлагает ни один другой известный нам Google MCP. Каждый инструмент проверен: 30 из 30 сквозных тестов проходят на реальных API Google, а не на заглушках. Если инструмент здесь указан, значит, он был выполнен на рабочих эндпоинтах Google и вернул ожидаемый результат.

MCP — это протокол, а не функция Claude. Любой клиент, поддерживающий протокол Model Context Protocol, может использовать этот сервер, независимо от того, какая модель стоит за ним.

Не знаете, с чего начать? Вставьте URL этого репозитория в Claude Code, Claude Desktop, Cursor или ChatGPT и попросите помочь с установкой. Файл SETUP.md написан так, чтобы ваш ИИ мог провести вас через каждый шаг, открыть нужные ссылки Google Cloud и в конце проверить, что все работает.

Что можно сделать за 60 секунд запросов

Это реальные результаты, достигаемые одним запросом, а не планы на будущее. Вставьте любой из них в свой MCP-клиент после подключения сервера.

• "Создай мне KPI-дашборд на листе Q4 с выручкой, CAC, оттоком и MRR, отформатированный, с условным цветовым выделением." → один вызов sheets_build_dashboard.

• "Создай новую таблицу под названием Clients с этими 12 столбцами, стилями заголовков, проверкой данных и закрепленной первой строкой." → один вызов sheets_build_sheet.

• "Найди все вхождения 'Q3 2025' на всех вкладках этой книги и замени их на 'Q4 2025'." → один вызов sheets_find_replace_many.

• "Создай Apps Script, привязанный к этой таблице, который отправляет мне сводку каждый понедельник в 8 утра, и разверни его как веб-приложение." → один вызов script_deploy.

• "Вставь таблицу цен из 5 столбцов в этот Google Документ с этими строками." → один вызов docs_insert_table.

• "Создай общую папку на Диске, перемести в нее эти три файла и установи права доступа 'просмотр для всех, у кого есть ссылка'."

• "Добавь условное форматирование, чтобы подсвечивать красным любую строку, где маржа ниже 15 процентов."

• "Защити формулы в столбце H, чтобы никто другой в таблице не мог их редактировать."

Никакого кода. Никаких ручных действий. Никакого переключения контекста из вашего ИИ-клиента.

Почему еще один MCP-сервер для Google Workspace?

Большинство Google MCP на GitHub делятся на две категории: коннекторы только для чтения, которые могут запрашивать таблицу, но не изменять ее, или узкоспециализированные адаптеры только для Таблиц, которые полностью игнорируют Документы, Диск и Apps Script. Это коннекторы: тонкие обертки над REST API, передаваемые ИИ, которому затем приходится тратить сорок вызовов инструментов и кучу токенов, чтобы хоть что-то сделать.

google-suite-mcp — это не коннектор. Это оператор. Примитивы здесь — это результаты (создать дашборд, развернуть скрипт, отформатировать отчет), а не эндпоинты (прочитать диапазон, записать ячейку, вывести список файлов). Операторы охватывают весь пакет, потому что реальная работа пересекает границы инструментов. Операторы предоставляют составные примитивы, потому что реальная работа — это никогда не редактирование одной ячейки.

Они идут своим путем, мы — своим.

Сравнение возможностей

Требования

• Node.js 20 или новее

• Аккаунт Google с доступом к файлам Workspace, которыми должен управлять ваш ИИ

• Проект Google Cloud (бесплатного уровня достаточно)

• Учетные данные OAuth 2.0 Desktop

• MCP-совместимый клиент: Claude Desktop, Cursor, Windsurf, Zed, VS Code (GitHub Copilot), Gemini CLI, Cline, Goose, любой агент на базе OpenAI Agents SDK или любой другой клиент, поддерживающий MCP

Заложите около десяти минут на первую настройку, если вы никогда раньше не работали с Google Cloud. Делается один раз, больше не потребуется.

Как установить google-suite-mcp?

npm install -g google-suite-mcp

Или пропустите глобальную установку и позвольте вашему MCP-клиенту загрузить его по требованию через npx -y google-suite-mcp (см. блоки конфигурации клиента ниже).

В любом случае сервер хранит свои учетные данные и токены OAuth в ~/.google-suite-mcp/. При первом запуске инструмента он точно скажет, куда поместить JSON вашего клиента OAuth Google Cloud, и откроет браузер для получения согласия. См. SETUP.md для выполнения однократных шагов в Google Cloud.

Как подключиться к Google Workspace?

Это единственная часть настройки, требующая реального внимания. Каждая ссылка ниже открывает именно ту страницу консоли Google Cloud, где нужно сделать следующий клик, поэтому вам не придется ничего искать.

Полное руководство: SETUP.md содержит каждый шаг по порядку с устранением неполадок для самых частых ошибок. Краткая версия:

1. Создайте проект Google Cloud (10 секунд, бесплатный уровень)

2. Включите четыре API (нажмите на каждую ссылку и нажмите Enable):

   • Sheets API

   • Docs API

   • Drive API

   • Apps Script API

3. Настройте экран согласия OAuth: выберите External и добавьте свой адрес электронной почты Google в качестве тестового пользователя

4. Создайте клиент OAuth 2.0 Desktop: Create Credentials > OAuth client ID > Desktop app. Скопируйте Client ID и Client Secret.

5. Вставьте учетные данные в .env:

cp .env.example .env

Затем отредактируйте .env и вставьте Client ID и Client Secret из шага 4.

При первом запуске инструмента сервер откроет ваш браузер, проведет вас через процесс согласия Google и локально закэширует токен обновления. Вам не придется проходить аутентификацию снова, если вы не отзовете доступ.

Если вы застряли на каком-либо шаге, вставьте SETUP.md в своего ИИ-ассистента и попросите его провести вас через каждый шаг по очереди.

Как подключить мой MCP-клиент?

Каждый MCP-совместимый клиент принимает одни и те же две вещи: command для запуска и список args. Блоки ниже используют npx, поэтому вам не нужно управлять локальным путем установки.

Claude Desktop

Откройте файл конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте эту запись:

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

Перезапустите Claude Desktop. 82 инструмента появятся в меню выбора инструментов.

Cursor, Windsurf, Zed, VS Code

У каждого клиента свое расположение конфигурации MCP, но они принимают одинаковый формат command и args. Обратитесь к документации MCP вашего клиента и вставьте блок выше в раздел MCP-серверов. Никаких других изменений не требуется.

Gemini CLI

Добавьте сервер в конфигурацию MCP Gemini CLI (~/.gemini/config.json или аналогичную), используя те же command и args.

OpenAI Agents SDK

OpenAI Agents SDK (Python и TypeScript) поддерживает MCP-серверы нативно. Передайте google-suite-mcp как MCP-сервер при создании агента, и 82 инструмента станут доступны любой выбранной вами модели OpenAI.

Любой другой MCP-клиент

Если он поддерживает протокол Model Context Protocol, он будет работать. Используйте тот же шаблон command и args везде, где ваш клиент определяет MCP-серверы.

Примеры использования

Как только сервер подключен, вы общаетесь со своим ИИ так же, как и всегда. Просто теперь у него есть руки.

Создание живого KPI-дашборда из схемы

"В книге под названием 'Q4 Forecast' создай новую вкладку 'Dashboard' и построй KPI-дашборд с четырьмя ячейками: Revenue, Gross Margin, CAC и Churn. Возьми значения с вкладки 'Raw', отформатируй заголовки жирным шрифтом, числа — как валюту, и подсвети красным все, что ниже целевого значения."

Один вызов sheets_build_dashboard. Готово.

Превращение схемы в таблицу

"Создай новую таблицу 'Client Tracker' со столбцами Name, Email, Status (выпадающий список: Lead / Active / Churned), Last Contact (дата) и Notes. Добавь условное форматирование, чтобы строки с Churned становились красными."

Один вызов sheets_build_sheet. Готово.

Написание документа с реальной структурой

"Составь бриф для проекта Henderson в Документах. Включи таблицу стейкхолдеров, таблицу таймлайна и раздел рисков с маркированным списком."

docs_insert_table создает настоящие таблицы, а не имитации из ASCII.

Развертывание веб-приложения Apps Script

"Создай новый проект Apps Script, привязанный к этой таблице, добавь doGet, который возвращает вкладку Summary в формате JSON, создай версию и разверни как веб-приложение, которое я могу вызвать через curl."

script_deploy публикует его. Вы получаете живой URL.

Переименование поля во всех листах книги

"В книге Expenses замени все вхождения 'customer_id' на 'account_id' во всех листах за один проход."

sheets_find_replace_many справляется за один вызов.

Организация Диска

"Создай папку '2026 Client Intake', перемести в нее все файлы на моем Диске, в названии которых есть 'intake', и открой доступ к папке для просмотра всем, у кого есть ссылка."

Краткий список инструментов (82 инструмента)

Группировка по сервисам Google:

• Google Таблицы (53 инструмента). Создание, список, чтение, запись, добавление, форматирование, условное форматирование, диаграммы, именованные диапазоны, защищенные диапазоны, фильтры, сортировка, проверка данных, границы, объединение, закрепление областей, изменение размера, поиск/замена (одиночный и sheets_find_replace_many по всем вкладкам), поиск, формулы, формулы массивов, пакетное обновление, дублирование, переименование, изменение порядка, удаление, sheets_build_sheet, sheets_build_dashboard.

• Google Документы (8 инструментов). Создание, запись, форматирование текста, получение текста, замена текста, вставка изображения, docs_insert_table, экспорт.

• Google Диск (12 инструментов). Загрузка, скачивание, поиск, получение информации, перемещение, копирование, переименование, удаление в корзину, создание папки, предоставление доступа, список и обновление прав доступа.

• Google Apps Script (7 инструментов). Создание, обновление, получение, получение привязанного, запуск, создание версии, script_deploy.

• Аутентификация (2 инструмента). Статус, обновление.

Каждый инструмент поставляется с эффективными ответами (token-efficient responses). Каждая полезная нагрузка была проверена от начала до конца и оптимизирована, чтобы ваше контекстное окно оставалось свободным при длительных агентных сессиях.

Для получения авторитетного списка с актуальными схемами вызовите tools/list из любого MCP-клиента после подключения или посмотрите src/tools/ в дереве исходного кода.

FAQ

Работает ли это с Cursor, Gemini CLI