Google Docs MCP: правка документов агентом в Claude Desktop и Cursor

a-bonus/google-docs-mcp· Проверено 12.11.2026· 686на GitHub

Даёт агенту читать и править Google Документы: текст, Markdown, стили, таблицы, комментарии и правки в режиме предложений. Тот же сервер работает с Таблицами, Диском, Gmail и Календарём.

Пакет npm со 107 инструментами по Docs, Sheets, Drive, Gmail, Calendar и Apps Script; вход через свой OAuth-клиент Google, можно развернуть для команды на Cloud Run.

Как подключить

Что сделать до подключения

Проект в Google Cloud Console с включёнными Google Docs, Sheets, Drive, Gmail и Calendar API

Экран согласия OAuth типа External: ваш адрес в тестовых пользователях, области documents, spreadsheets, drive, gmail.modify и calendar.events

OAuth client ID типа Desktop app

Один раз авторизоваться: GOOGLE_CLIENT_ID=… GOOGLE_CLIENT_SECRET=… npx -y @a-bonus/google-docs-mcp auth

GOOGLE_CLIENT_ID

Google Cloud Console → APIs & Services → Credentials → Create credentials → OAuth client ID, тип Desktop app

GOOGLE_CLIENT_SECRET

там же, на экране подтверждения после создания клиента

GOOGLE_MCP_PROFILE

необязательно: имя профиля, чтобы держать токены нескольких аккаунтов раздельно

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'GOOGLE_CLIENT_ID=<Client ID>' --env 'GOOGLE_CLIENT_SECRET=<Client Secret>' --transport stdio google-docs \
  -- npx -y @a-bonus/google-docs-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.google-docs]
command = "npx"
args = ["-y", "@a-bonus/google-docs-mcp"]

[mcp_servers.google-docs.env]
GOOGLE_CLIENT_ID = "<Client ID>"
GOOGLE_CLIENT_SECRET = "<Client Secret>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@a-bonus/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "<Client ID>",
        "GOOGLE_CLIENT_SECRET": "<Client Secret>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "google-docs": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a-bonus/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "<Client ID>",
        "GOOGLE_CLIENT_SECRET": "<Client Secret>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@a-bonus/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "<Client ID>",
        "GOOGLE_CLIENT_SECRET": "<Client Secret>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@a-bonus/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "<Client ID>",
        "GOOGLE_CLIENT_SECRET": "<Client Secret>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "google-docs": {
        "type": "local",
        "command": ["npx", "-y", "@a-bonus/google-docs-mcp"],
        "environment": {
          "GOOGLE_CLIENT_ID": "<Client ID>",
          "GOOGLE_CLIENT_SECRET": "<Client Secret>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@a-bonus/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "<Client ID>",
        "GOOGLE_CLIENT_SECRET": "<Client Secret>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@a-bonus/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "<Client ID>",
        "GOOGLE_CLIENT_SECRET": "<Client Secret>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

readDocumentчитает документ текстом, JSON или Markdown

replaceDocumentWithMarkdownзаменяет документ из Markdown

findAndReplaceнаходит и заменяет текст

applyTextStyleделает текст жирным, цветным, ссылкой

insertTableWithDataвставляет заполненную таблицу

insertImageвставляет картинку

addCommentоставляет комментарий к тексту

listSuggestionsпоказывает предложенные правки

readSpreadsheetчитает диапазон таблицы

writeSpreadsheetзаписывает данные в диапазон

appendRowsдобавляет строки

formatCellsоформляет ячейки

insertChartстроит диаграмму

searchDocumentsищет документы по имени и тексту

createDocumentFromTemplateсоздаёт документ из шаблона

moveFileпереносит файл в папку

triageInboxразбирает непрочитанные письма

createDraftготовит черновик письма

createEventсоздаёт событие в Календаре

updateAppsScriptContentпишет код Apps Script

Показано 20 из 107.

Что попросить агента

«Прочитай документ <ID> в Markdown»Агент вызовет readDocument с format markdown

«Сделай текст «Важно» жирным и красным в документе <ID>»Агент вызовет applyTextStyle

«Замени весь документ <ID> этим Markdown: <текст>»Агент вызовет replaceDocumentWithMarkdown

«Запиши [[Name, Score], [Alice, 95], [Bob, 87]] в A1 таблицы <ID>»Агент вызовет writeSpreadsheet

«Найди документы со словами «project proposal» и перенеси их в папку <ID папки>»Агент вызовет searchDocuments, затем moveFile

Для каких задач

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

Найти и заменить текст, оформить заголовки, вставить таблицу или картинку

Оставить комментарии и правки в режиме предложений вместо прямых изменений

Записать данные в Google Таблицу, оформить её и построить диаграмму

Найти документы на Диске и разложить их по папкам

Разобрать непрочитанную почту и поставить встречу в Календарь

Ограничения

Нужен свой проект Google Cloud с включёнными API и OAuth-клиентом, без него сервер не войдёт

Комментарии через API не привязываются к тексту в интерфейсе Docs; статус «решено» может не сохраниться

Картинки из Markdown не переносятся, списки глубже трёх уровней могут поехать; документы, сконвертированные из Word, поддерживают не все операции

Gmail отправляет только простой текст и не скачивает вложения; Apps Script API нужно один раз включить вручную в каждом аккаунте

Если не работает

Сервер не запускается

Проверьте, что GOOGLE_CLIENT_ID и GOOGLE_CLIENT_SECRET заданы в блоке env конфига. Запустите npx @a-bonus/google-docs-mcp вручную и посмотрите ошибки в stderr.

Ошибки авторизации Google

Включите Docs, Sheets, Drive, Gmail и Calendar API, добавьте себя в тестовые пользователи и все области на экран согласия, затем заново выполните auth. После обновления удалите token.json: области Gmail и Calendar добавились позже.

403 с упоминанием Apps Script API

Apps Script API выключен по умолчанию: включите его в аккаунте на https://script.google.com/home/usersettings.

Ошибки вкладок документа

Узнайте ID вкладок через listTabs; для документов с одной вкладкой не передавайте tabId.

В Claude.ai при входе в развёрнутый сервер открывается «Page not found»

Это холодный старт Cloud Run: обновите страницу через Ctrl+Shift+R. Чтобы не повторялось, задайте сервису --min-instances=1.

Частые вопросы

Есть ли у Google свой MCP для Google Docs?

В каталоге google/mcp Google указывает открытый сервер Google Workspace в виде расширения Gemini CLI, репозиторий gemini-cli-extensions/workspace: Docs, Sheets, Slides, Calendar и Gmail. На этой странице описан сторонний сервер a-bonus.

Где хранится вход в Google?

Токен обновления лежит в ~/.config/google-docs-mcp/token.json, Client ID и секрет туда не пишутся. Чтобы войти заново, снова выполните команду auth или удалите файл.

Как подключить несколько аккаунтов Google?

Задайте каждому экземпляру сервера свой GOOGLE_MCP_PROFILE, например work и personal. Токены лягут в отдельные папки ~/.config/google-docs-mcp/<профиль>/.

Можно работать через сервисный аккаунт?

Да, вместо OAuth задайте SERVICE_ACCOUNT_PATH с путём к JSON-ключу и при необходимости GOOGLE_IMPERSONATE_USER с адресом пользователя, от имени которого работать.

Можно развернуть сервер для всей команды?

Да, на Cloud Run с MCP_TRANSPORT=httpStream, BASE_URL и OAuth-клиентом типа Web application. Сотрудники добавляют адрес https://<сервис>.run.app/mcp и входят через Google при первом подключении.

Как подключить Google Docs MCP к Claude Desktop?

Создайте OAuth-клиент типа Desktop app, выполните npx -y @a-bonus/google-docs-mcp auth с GOOGLE_CLIENT_ID и GOOGLE_CLIENT_SECRET и войдите в браузере. Затем добавьте сервер в конфиг Claude Desktop с теми же переменными, клиент запустит его сам.

Работает ли сервер из России?

Сервер работает у вас, но обращается к API Google через ваш OAuth-клиент из Google Cloud Console, поэтому нужен рабочий доступ к сервисам Google.