Google Workspace MCP

taylorwilsdon/google_workspace_mcp· Проверено 12.11.2026· 3,5 тыс.на GitHub

Один сервер на Gmail, Диск, Календарь, Документы, Таблицы, Презентации, Формы, Задачи, Контакты, Chat, Custom Search и Apps Script: больше 120 инструментов с отбором по уровням и режимом только чтения.

Python, ставится через uvx; работает по stdio на вашем компьютере или по HTTP с многопользовательским OAuth 2.1 для команды.

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

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

uv с командой uvx; Python 3.10 или новее

Проект в Google Cloud Console с включёнными API нужных сервисов и OAuth-клиентом

GOOGLE_OAUTH_CLIENT_ID

Google Cloud Console → ваш проект → OAuth-клиент, вида your-client-id.apps.googleusercontent.com

GOOGLE_OAUTH_CLIENT_SECRET

секрет того же OAuth-клиента

USER_GOOGLE_EMAIL

необязательно: ваш адрес по умолчанию, чтобы агенту не называть его при входе

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

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

claude mcp add --env 'GOOGLE_OAUTH_CLIENT_ID=<OAuth Client ID>' --env 'GOOGLE_OAUTH_CLIENT_SECRET=<OAuth Client Secret>' --transport stdio google-workspace \
  -- uvx workspace-mcp --tool-tier core

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

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

[mcp_servers.google-workspace]
command = "uvx"
args = ["workspace-mcp", "--tool-tier", "core"]

[mcp_servers.google-workspace.env]
GOOGLE_OAUTH_CLIENT_ID = "<OAuth Client ID>"
GOOGLE_OAUTH_CLIENT_SECRET = "<OAuth Client Secret>"

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

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

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tool-tier", "core"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "google-workspace": {
      "type": "stdio",
      "command": "uvx",
      "args": ["workspace-mcp", "--tool-tier", "core"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tool-tier", "core"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tool-tier", "core"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth 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-workspace": {
        "type": "local",
        "command": ["uvx", "workspace-mcp", "--tool-tier", "core"],
        "environment": {
          "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
          "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
        }
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tool-tier", "core"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tool-tier", "core"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

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

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

search_gmail_messagesищет письма в Gmail

get_gmail_message_contentчитает письмо

send_gmail_messageотправляет письмо

draft_gmail_messageсоздаёт черновик

search_drive_filesищет файлы на Диске

get_drive_file_contentчитает файл с Диска

create_drive_fileсоздаёт файл на Диске

get_drive_shareable_linkвыдаёт ссылку на файл

get_eventsпоказывает события календаря

manage_eventсоздаёт и меняет событие

query_freebusyпроверяет занятость

create_docсоздаёт документ

modify_doc_textправит текст документа

export_doc_to_pdfэкспортирует документ в PDF

read_sheet_valuesчитает ячейки таблицы

modify_sheet_valuesзаписывает значения в таблицу

create_presentationсоздаёт презентацию

list_form_responsesчитает ответы формы

manage_taskсоздаёт и меняет задачу

run_script_functionзапускает функцию Apps Script

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

«Найди непрочитанные письма от <отправитель> и перескажи их»Агент вызовет search_gmail_messages и get_gmail_message_content

«Поставь встречу «<тема>» на <дата и время> с <адреса> и проверь, что все свободны»Агент вызовет query_freebusy, затем manage_event

«Найди на Диске файл «<название>» и дай ссылку»Агент вызовет search_drive_files и get_drive_shareable_link

«Собери документ с итогами встречи и выгрузи его в PDF»Агент вызовет create_doc, modify_doc_text и export_doc_to_pdf

«Запиши эти данные в таблицу <ссылка на таблицу> начиная с A2: <данные>»Агент вызовет modify_sheet_values и проверит результат через read_sheet_values

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

Найти письма по запросу, пересказать их и подготовить ответ черновиком

Поставить встречу в календарь и проверить, когда участники свободны

Найти файл на Диске, прочитать его и выдать ссылку

Собрать документ, отформатировать и выгрузить в PDF

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

Создать форму и собрать ответы на неё

Ограничения

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

Google Chat требует разовой настройки Chat-приложения и аккаунта Google Workspace

Письма, документы и события могут содержать скрытые инструкции для модели; инструменты записи включайте осознанно, для чтения есть флаг --read-only

Многопользовательский OAuth 2.1 работает только по HTTP; для удалённого или общего сервера нужны HTTPS и OAuth 2.1

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

uvx workspace-cli ставит чужой пакет

Это имя в PyPI занято заброшенным пакетом. Ставьте CLI из репозитория командой uv tool install . или запускайте uv run workspace-cli.

HTTP-сервер отвечает 403 на запросы клиентов или проверок состояния

Задан WORKSPACE_MCP_ALLOWED_HOSTS: впишите в него все имена хостов, по которым ходят клиенты и проверки.

Загрузка файла из папки Drive для компьютера зависает

Папки, синхронизированные с облаком, могут обрывать загрузку. Скопируйте файл в обычную локальную папку.

Ссылка на вложение из Google Cloud Storage отвечает 403

Сервисному аккаунту не хватает чтения объектов: выдайте roles/storage.objectUser или roles/storage.objectCreator вместе с roles/storage.objectViewer.

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

Как не забить контекст сотней инструментов?

Выберите уровень: --tool-tier core оставляет основные, extended добавляет управление, complete грузит всё. Флаг --tools gmail drive calendar оставляет только нужные сервисы, --disabled-tools убирает отдельные инструменты.

Как запретить агенту что-то менять?

Запустите с флагом --read-only: сервер запросит только права на чтение и отключит инструменты записи. Для точной настройки по сервисам есть --permissions.

Подойдёт бесплатный аккаунт Google?

Да, сервер работает с бесплатными аккаунтами и всеми тарифами Google Workspace. Google Chat и пространства доступны только с аккаунтом Workspace.

Как подключить к Claude Desktop или Claude Code?

Для Claude Desktop рекомендован режим HTTP: uvx workspace-mcp --transport streamable-http и коннектор в Settings → Connectors → Add custom connector. В Claude Code после запуска по HTTP: claude mcp add --transport http workspace-mcp http://localhost:8000/mcp.

Куда сервер отправляет данные?

По умолчанию только в API Google от имени вошедшего пользователя. Встроенной телеметрии и аналитики нет, трассировка OpenTelemetry выключена, пока вы её не настроите.

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

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