Google Workspace — MCP-сервер для Claude Code: настройка
Подключает агента к сервисам Google: почте, календарям, файлам на Диске и таблицам. Позволяет управлять несколькими аккаунтами прямо из диалога.
claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --transport stdio google-workspace -- npx -y @aaronsb/google-workspace-mcpЧто делает Google Workspace
Интеграция даёт доступ к восьми сервисам Google, включая Gmail, Calendar, Drive, Docs, Sheets, Tasks и Meet. Управление идёт через специализированные инструменты вроде manage_email или manage_calendar. Агент может искать письма, назначать встречи, читать строки из таблиц и вносить правки в документы.
Для работы обязательны учётные данные OAuth 2.0 с типом приложения Desktop app из Google Cloud Console и среда Node версии не ниже 22.12. Токены хранятся на вашем компьютере и не уходят на внешние серверы. Без ключей OAuth сервер не запустится. В конфигурации можно держать сразу рабочий и личный аккаунты, между которыми сервер переключается сам.
Какие задачи решает
- искать письма и отправлять ответы в цепочки Gmail
- планировать встречи и проверять свободные слоты в Google Calendar
- выгружать файлы и читать диапазоны ячеек в Google Sheets
- создавать задачи и списки дел в Google Tasks
Примеры запросов агенту
- Проверь расписание в Google Calendar на завтра и найди свободное окно после обеда.
- Найди в Gmail последнее письмо от бухгалтерии и скачай прикреплённую смету.
- Добавь в таблицу отчёта новую строку с суммами расходов за прошлую неделю.
Как установить Google Workspace
Командой платформы
claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --transport stdio google-workspace -- npx -y @aaronsb/google-workspace-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add google-workspace --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -- npx -y @aaronsb/google-workspace-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"google-workspace": {
"command": "npx",
"args": [
"-y",
"@aaronsb/google-workspace-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"google-workspace": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@aaronsb/google-workspace-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> google-workspace npx -y @aaronsb/google-workspace-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Google Workspace
Как установить Google Workspace в Claude Code?
Выполните команду `claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --transport stdio google-workspace -- npx -y @aaronsb/google-workspace-mcp`. Вместо плейсхолдеров укажите ваши Client ID и Client Secret.
Что нужно подготовить перед запуском сервера?
В Google Cloud Console создайте Client ID типа Desktop app и включите нужные API, включая People API для контактов. На компьютере должен быть установлен Node версии 22.12 или новее.
Где хранятся токены авторизации аккаунтов?
Все данные авторизации остаются на вашем диске. Сервер обращается к API напрямую от вашего имени без посредников.
