google-docs — MCP-сервер для Google Docs: что делает и как установить
Даёт агенту доступ к Google Документам: читать, создавать, править и экспортировать файлы, если у вас есть OAuth2 или сервисный аккаунт Workspace.
claude mcp add --env GOOGLE_DOCS_OAUTH_CLIENT_ID=<GOOGLE_DOCS_OAUTH_CLIENT_ID> --env GOOGLE_DOCS_OAUTH_CLIENT_SECRET=<GOOGLE_DOCS_OAUTH_CLIENT_SECRET> --env GOOGLE_DOCS_OAUTH_REFRESH_TOKEN=<GOOGLE_DOCS_OAUTH_REFRESH_TOKEN> --env GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL=<GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL> --env GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY=<GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY> --transport stdio google-docs -- npx -y google-docs-workspace-mcp-serverЧто делает google-docs
Сервер работает с Google Документами через API Docs и Drive. Агенту доступны чтение тела документа или его оглавления по ID либо по ссылке, создание нового файла с начальным текстом, добавление текста в конец, вставка по индексу, замена всех вхождений строки и произвольные запросы documents.batchUpdate для правки структуры. Ещё он умеет отправлять документ в корзину Drive или удалять насовсем, экспортировать в Markdown, HTML, PDF, DOCX и другие форматы.
Авторизация двух видов. Личный аккаунт @gmail.com подключается через OAuth2: в Google Cloud Console включаются Google Docs API и Google Drive API, создаются креды типа Desktop app, затем refresh token добывается командой npx google-docs-workspace-mcp-server oauth-setup <client_id> <client_secret>. Аккаунт Google Workspace идёт через сервисный аккаунт с доменной делегацией, а в Admin Console ему выдаются scopes на documents и drive.
Отдельные группы инструментов отключаются переменной GOOGLE_DOCS_ENABLED_TOOLGROUPS — так доступ сужается до нужного набора, включая шаринг документов. Без опубликованного OAuth consent screen refresh token живёт семь дней, поэтому настройку придётся повторять; публикация снимает эту проблему и полной верификации Google не требует.
Какие задачи решает
- прочитать текст или оглавление Google Docs по ссылке
- создать документ и дописать в него текст
- заменить все вхождения строки в документе
- выгрузить документ в Markdown или PDF
- выдать доступ к документу пользователю или группе
Примеры запросов агенту
- Прочитай оглавление документа по ссылке и покажи структуру
- Создай Google Doc с черновиком релиз-нот и выгрузи его в Markdown
- Замени в документе все вхождения старого названия на новое
Как установить google-docs
Командой платформы
claude mcp add --env GOOGLE_DOCS_OAUTH_CLIENT_ID=<GOOGLE_DOCS_OAUTH_CLIENT_ID> --env GOOGLE_DOCS_OAUTH_CLIENT_SECRET=<GOOGLE_DOCS_OAUTH_CLIENT_SECRET> --env GOOGLE_DOCS_OAUTH_REFRESH_TOKEN=<GOOGLE_DOCS_OAUTH_REFRESH_TOKEN> --env GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL=<GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL> --env GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY=<GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY> --transport stdio google-docs -- npx -y google-docs-workspace-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add google-docs --env GOOGLE_DOCS_OAUTH_CLIENT_ID=<GOOGLE_DOCS_OAUTH_CLIENT_ID> --env GOOGLE_DOCS_OAUTH_CLIENT_SECRET=<GOOGLE_DOCS_OAUTH_CLIENT_SECRET> --env GOOGLE_DOCS_OAUTH_REFRESH_TOKEN=<GOOGLE_DOCS_OAUTH_REFRESH_TOKEN> --env GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL=<GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL> --env GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY=<GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY> -- npx -y google-docs-workspace-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"google-docs": {
"command": "npx",
"args": [
"-y",
"google-docs-workspace-mcp-server"
],
"env": {
"GOOGLE_DOCS_OAUTH_CLIENT_ID": "<GOOGLE_DOCS_OAUTH_CLIENT_ID>",
"GOOGLE_DOCS_OAUTH_CLIENT_SECRET": "<GOOGLE_DOCS_OAUTH_CLIENT_SECRET>",
"GOOGLE_DOCS_OAUTH_REFRESH_TOKEN": "<GOOGLE_DOCS_OAUTH_REFRESH_TOKEN>",
"GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL>",
"GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY": "<GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"google-docs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-docs-workspace-mcp-server"
],
"env": {
"GOOGLE_DOCS_OAUTH_CLIENT_ID": "<GOOGLE_DOCS_OAUTH_CLIENT_ID>",
"GOOGLE_DOCS_OAUTH_CLIENT_SECRET": "<GOOGLE_DOCS_OAUTH_CLIENT_SECRET>",
"GOOGLE_DOCS_OAUTH_REFRESH_TOKEN": "<GOOGLE_DOCS_OAUTH_REFRESH_TOKEN>",
"GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL>",
"GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY": "<GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e GOOGLE_DOCS_OAUTH_CLIENT_ID=<GOOGLE_DOCS_OAUTH_CLIENT_ID> -e GOOGLE_DOCS_OAUTH_CLIENT_SECRET=<GOOGLE_DOCS_OAUTH_CLIENT_SECRET> -e GOOGLE_DOCS_OAUTH_REFRESH_TOKEN=<GOOGLE_DOCS_OAUTH_REFRESH_TOKEN> -e GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL=<GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL> -e GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY=<GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY> google-docs npx -y google-docs-workspace-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о google-docs
Как установить google-docs в Claude Code?
Одной командой: `claude mcp add google-docs -e GOOGLE_DOCS_OAUTH_CLIENT_ID=<GOOGLE_DOCS_OAUTH_CLIENT_ID> -e GOOGLE_DOCS_OAUTH_CLIENT_SECRET=<GOOGLE_DOCS_OAUTH_CLIENT_SECRET> -e GOOGLE_DOCS_OAUTH_REFRESH_TOKEN=<GOOGLE_DOCS_OAUTH_REFRESH_TOKEN> -e GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY=<GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY> -- npx -y google-docs-workspace-mcp-server`. Подставьте свои значения переменных перед запуском.
Что делает google-docs?
Подключает к агенту Google Документы: чтение, создание, правка, удаление и экспорт файлов, а также выдача прав доступа. Работает через API Docs и Drive.
Какой способ авторизации выбрать?
Для личного аккаунта @gmail.com — OAuth2 с refresh token. Для организации Google Workspace — сервисный аккаунт с доменной делегацией и выданными scopes.
