taylorwilsdon/google_workspace_mcp

taylorwilsdon/google_workspace_mcp

от taylorwilsdon
Управляет Gmail, Календарём, Диском, Документами, Таблицами и Презентациями: пишет письма, создаёт события, редактирует файлы.

Google Workspace MCP Server

License: MIT Python 3.10+ PyPI PyPI Downloads MCP Toplist Website

readme-banner

Full natural language control over Google Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, Contacts, and Chat through all MCP clients, AI assistants and developer tools. Includes a full featured CLI & Code Mode for use with tools like Claude Code and Codex!

The most feature-complete Google Workspace MCP server is in a class of it's own: it can do things that Google's own tooling and the built in integrations with Claude and ChatGPT can't come close to with multi-user support, rich fine-grained editing tools and the most extensive coverage of any Workspace AI integration in existence.

By leveraging native OAuth 2.1, stateless deployment capability and external auth server & gateway passthrough auth support, it's also the only Workspace MCP you can host for your whole organization centrally & securely!

Supports all free Google accounts & Google Workspace plans with expanded app options like Chat & Spaces.
Interested in a managed cloud instance? That can be arranged (starting at $5/mo).

Часто задаваемые вопросы

Инструменты были проиндексированы:
append_table_rowsвнешний мир

Добавляет строки в структурированную таблицу в Google Sheet. Строки добавляются в конец тела таблицы, автоматически расширяя её диапазон. Сначала используйте list_sheet_tables, чтобы найти ID таблицы.

Добавить строки таблицы

Параметры
  • spreadsheet_idstringобязательный

    Идентификатор электронной таблицы. Обязателен.

  • table_idstringобязательный

    Идентификатор таблицы для добавления данных (получить из list_sheet_tables). Обязательно.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

  • valuesstring | any[][]обязательный

    Двумерный массив значений для добавления. Каждый внутренний список — это одна строка. Может быть JSON-строкой или списком Python. Обязательный параметр.

batch_modify_gmail_message_labelsвнешний мир

Добавляет или удаляет метки для нескольких сообщений Gmail в одном пакетном запросе. Принимает MESSAGE ids, а не thread ids. Пакетная конечная точка Gmail не возвращает результат по каждому сообщению и молча игнорирует нераспознанные идентификаторы, поэтому по умолчанию инструмент после этого считывает сообщения и сообщает, какие идентификаторы фактически изменились.

Пакетное изменение меток сообщений Gmail

Параметры
  • add_label_idsstring[]

    Список ID меток, которые нужно добавить к сообщениям.

  • message_idsstring[]обязательный

    Предоставляет список идентификаторов сообщений для изменения.

  • remove_label_idsstring[]

    Список идентификаторов меток для удаления из сообщений.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

  • verifyboolean

    Считывает сообщения обратно и выдаёт результат по каждому id. Стоит одного дополнительного (пакетного) чтения на id. Установите False для очень больших прогонов, где эти затраты важны и допустим непроверенный результат.

batch_update_docвнешний мир

Выполняет несколько низкоуровневых операций с документом в одном атомарном пакетном обновлении. Для обычного текста верхних/нижних колонтитулов используй update_doc_headers_footers. Используй create_header_footer здесь только для продвинутых макетов с разрывами разделов. РЕКОМЕНДУЕМЫЙ ПОРЯДОК РАБОТЫ ПРИ ПОСТРОЕНИИ ДОКУМЕНТОВ: ============================================= Чтобы избежать ошибок при вычислении индексов, строй документы поэтапно: ФАЗА 1 — ВСТАВКА ВСЕГО СОДЕРЖИМОГО (используй end_of_segment=true, без работы с индексами): Добавляй текст, разрывы разделов и разрывы страниц последовательно. Каждая операция добавляет данные в конец тела документа. Индекс не нужен. Пример пакета: [ {"type": "insert_text", "end_of_segment": true, "text": "Report Title\n"}, {"type": "insert_text", "end_of_segment": true, "text": "\nExecutive Summary\n"}, {"type": "insert_text", "end_of_segment": true, "text": "Revenue grew 15%.\n"}, {"type": "insert_section_break", "end_of_segment": true, "section_type": "NEXT_PAGE"}, {"type": "insert_text", "end_of_segment": true, "text": "Detailed Analysis\n"} ] ФАЗА 2 — СОЗДАНИЕ ВЕРХНИХ/НИЖНИХ КОЛОНТИТУЛОВ (если нужно): Для обычного текста колонтитулов используй update_doc_headers_footers (он сам создаёт колонтитул, если его нет, и записывает туда содержимое). Включай операции create_header_footer в пакет, только когда осознанно управляешь макетом, специфичным для разрыва раздела.

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

Параметры
  • document_idstringобязательный

    Идентификатор документа для обновления.

  • operationsobject[]обязательный

    Список словарей операций. Каждая операция ОБЯЗАТЕЛЬНО должна иметь поле 'type'. Все операции принимают необязательный параметр 'tab_id' для указания конкретной вкладки.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

batch_update_formвнешний мир

Применяет пакетные обновления к Google Форме. Поддерживает добавление, обновление и удаление элементов формы, а также обновление метаданных и настроек. Это основной метод изменения содержимого формы после её создания.

Batch Update Form

Параметры
  • form_idstringобязательный

    Идентификатор формы для обновления.

  • requestsobject[]обязательный

    Список запросов на обновление для применения. Поддерживаемые типы запросов: - createItem: добавляет новый вопрос или элемент контента - updateItem: изменяет существующий элемент - deleteItem: удаляет элемент - moveItem: меняет порядок элемента - updateFormInfo: обновляет название или описание формы - updateSettings: изменяет настройки формы (например, режим викторины)

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

batch_update_presentationвнешний мир

Применить пакетные обновления к презентации Google Slides.

Пакетное обновление презентации

Параметры
  • presentation_idstringобязательный

    Идентификатор презентации, которую нужно обновить.

  • requestsobject[]обязательный

    Список запросов на обновление для применения.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

check_drive_file_public_accessтолько чтениеидемпотентныйвнешний мир

Ищет файл по имени и проверяет, включён ли у него общий доступ по ссылке.

Проверяет публичный доступ к файлу на Диске

Параметры
  • drive_idstring

    ID общего диска, по которому нужно ограничить поиск. Когда параметр задан, базовый вызов files.list использует corpora='drive' и указанный driveId. Это необходимо, чтобы надёжно находить файлы, которые находятся только на этом общем диске. Когда параметр равен None, поведение не меняется (применяется стандартный API corpora).

  • file_namestringобязательный

    Имя файла для проверки.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

copy_drive_fileвнешний мир

Создает копию существующего файла Google Drive. Этот инструмент копирует документ-шаблон в новое место, с возможностью задать новое имя. Копия сохраняет все форматирование и содержимое исходного файла.

Копировать файл Drive

Параметры
  • file_idstringобязательный

    ID файла для копирования. Обязательно.

  • new_namestring

    Новое имя для скопированного файла. Если не указано, используется «Копия [оригинального имени]».

  • parent_folder_idstring

    Идентификатор папки, в которой должна быть создана копия. По умолчанию — 'root' (Мой диск).

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

create_calendarвнешний мир

Создаёт новый дополнительный календарь Google.

Создаёт календарь

Параметры
  • descriptionstring

    Необязательное описание для календаря.

  • summarystringобязательный

    Название нового календаря.

  • timezonestring

    Часовой пояс IANA для календаря (например, 'America/New_York').

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

create_docвнешний мир

Создаёт новый Google Doc и опционально вставляет начальное содержимое. После создания тело документа начинается с индекса 1. Новый пустой документ имеет общую длину 2 (один разрыв раздела на индексе 0, один перевод строки на индексе 1). Чтобы собрать сложный документ после создания, используйте batch_update_doc с операциями insert_text, применяя end_of_segment=true, чтобы добавлять содержимое последовательно, не вычисляя индексы. Затем вызовите inspect_doc_structure, чтобы получить точные позиции перед применением форматирования отдельным пакетным вызовом.

Создать документ

Параметры
  • contentstring

    Необязательное начальное содержимое в виде обычного текста для вставки

  • folder_idstring

    Идентификатор родительской папки. По умолчанию используется 'root'. Для общих дисков это должен быть идентификатор папки внутри общего диска.

  • titlestringобязательный

    Заголовок нового документа

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

create_drive_fileвнешний мир

Создает новый файл в Google Drive, поддерживая создание в общих дисках. Принимает прямой текст, встроенные base64-байты или fileUrl для загрузки содержимого. Сохраняет переданные байты без преобразования в Google Docs, Sheets или Slides. Для конвертации в нативные форматы Google используйте соответствующий инструмент import_to_google_*.

Создаёт файл Drive

Параметры
  • base64_contentstring

    Байты файла в стандартной base64-кодировке.

  • base64_sha256string

    Ожидаемый SHA-256 декодированного base64_content. Рекомендуется для проверки целостности бинарных данных.

  • contentstring

    Если указано, содержимое для записи в файл.

  • content_mime_typestring

    Тип MIME для загрузок base64_content.

  • file_namestringобязательный

    Имя для нового файла.

  • fileUrlstring

    Если указано, получает содержимое файла по этому URL. Поддерживает протоколы file://, http:// и https://.

  • folder_idstring

    Идентификатор родительской папки. По умолчанию используется 'root'. Для общих дисков это должен быть идентификатор папки внутри общего диска.

  • mime_typestring

    MIME-тип файла. По умолчанию 'text/plain'; обязателен вместе с return_upload_url.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

create_drive_folderвнешний мир

Создаёт новую папку в Google Drive, поддерживая создание в общих дисках.

Создаёт папку Drive

Параметры
  • folder_namestringобязательный

    Имя для новой папки.

  • parent_folder_idstring

    Идентификатор родительской папки. По умолчанию — 'root'. Для общих дисков используйте идентификатор папки внутри этого общего диска.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

create_formвнешний мир

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

Создать форму

Параметры
  • descriptionstring

    Описание формы.

  • document_titlestring

    Заголовок документа (отображается во вкладке браузера).

  • titlestringобязательный

    Заголовок формы.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

create_presentationвнешний мир

Создаёт новую презентацию в Google Slides.

Создать презентацию

Параметры
  • titlestring

    Название для новой презентации. По умолчанию установлено «Без названия».

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

create_reactionвнешний мир

Добавляет реакцию-эмодзи к сообщению в Google Chat.

Создать реакцию

Параметры
  • emoji_unicodestringобязательный

    Символ для реакции (например, 👍).

  • message_idstringобязательный

    Имя ресурса сообщения (например, spaces/X/messages/Y).

  • user_google_emailstringобязательный
create_sheetвнешний мир

Создаёт новый лист или дублирует существующий (user_google_email: str, spreadsheet_id: str, sheet_name: Optional[str] = None, source_sheet_name: Optional[str] = None, insert_sheet_index: Optional[int] = None).

Создать лист

Параметры
  • insert_sheet_indexinteger
  • sheet_namestring
  • source_sheet_namestring
  • spreadsheet_idstringобязательный
  • user_google_emailstringобязательный
create_spreadsheetвнешний мир

Создает новую Google Таблицу.

Создать таблицу

Параметры
  • folder_idstring

    Идентификатор родительской папки. По умолчанию используется 'root'. Для общих дисков это должен быть идентификатор папки внутри общего диска.

  • sheet_namesstring[]

    Список имён листов для создания. Если не указано, создаётся один лист с именем по умолчанию.

  • titlestringобязательный

    Название новой таблицы. Обязательно.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

create_table_with_dataвнешний мир

Создаёт таблицу и заполняет её данными за одну надёжную операцию. КРИТИЧЕСКИ ВАЖНО: СНАЧАЛА ВЫЗОВИТЕ inspect_doc_structure, ЧТОБЫ ПОЛУЧИТЬ ИНДЕКС! ОБЯЗАТЕЛЬНЫЙ ПОРЯДОК ДЕЙСТВИЙ - ВЫПОЛНЯЙТЕ ШАГИ ПО ПОРЯДКУ: Шаг 1: ВСЕГДА сначала вызывайте inspect_doc_structure Шаг 2: Используйте значение 'total_length' из inspect_doc_structure как индекс Шаг 3: Форматируйте данные как двумерный список: [["col1", "col2"], ["row1col1", "row1col2"]] Шаг 4: Вызовите эту функцию с правильным индексом и данными ПРИМЕР ФОРМАТА ДАННЫХ: table_data = [ ["Header1", "Header2", "Header3"], # Строка 0 - заголовки ["Data1", "Data2", "Data3"], # Строка 1 - первая строка данных ["Data4", "Data5", "Data6"] # Строка 2 - вторая строка данных ] КРИТИЧЕСКИЕ ТРЕБОВАНИЯ К ИНДЕКСУ: - НИКОГДА не используйте значения индекса, такие как 1, 2, 10, без предварительного вызова inspect_doc_structure - ВСЕГДА получайте индекс из поля 'total_length' в inspect_doc_structure - Индекс должен быть корректной точкой вставки в документе ТРЕБОВАНИЯ К ФОРМАТУ ДАННЫХ: - Только двумерный список строк - Каждый внутренний список = одна строка таблицы - ВСЕ строки ДОЛЖНЫ иметь одинаковое количество столбцов - Для пустых ячеек используйте пустые строки "", никогда None - После создания используйте debug_table_structure, чтобы проверить результаты

Создаёт таблицу с данными

Параметры
  • bold_headersboolean

    Делать ли первую строку жирной (по умолчанию: true)

  • document_idstringобязательный

    Идентификатор документа для обновления.

  • header_rowsinteger

    Количество начальных строк, помечаемых как повторяющийся заголовок, который появляется после каждого разрыва страницы. Допустимые значения — от 0 до количества строк таблицы (по умолчанию: 0 = нет).

  • indexintegerобязательный

    Позиция документа (ОБЯЗАТЕЛЬНО: получи из inspect_doc_structure параметр 'total_length')

  • tab_idstring

    Необязательный идентификатор вкладки для создания таблицы в конкретной вкладке.

  • table_datastring[][]обязательный

    Двумерный список строк - ТОЧНЫЙ формат: [["col1", "col2"], ["row1col1", "row1col2"]]

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

debug_docs_runtime_infoтолько чтениеидемпотентныйвнешний мир

Возвращает информацию о среде выполнения/исходном коде для диагностики устаревших экземпляров сервера MCP. Это временный диагностический инструмент, предназначенный для проверки того, какой срез кода загрузил запущенный сервер MCP.

Debug Docs Runtime Info

Параметры
  • user_google_emailstringобязательный
debug_table_structureтолько чтениеидемпотентныйвнешний мир

ВАЖНЫЙ ИНСТРУМЕНТ ОТЛАДКИ - Используйте его, когда таблицы работают не так, как ожидается. ИСПОЛЬЗУЙТЕ ЕГО НЕМЕДЛЕННО, КОГДА: - Заполнение таблицы поместило данные в неверные ячейки - Появляются ошибки "table not found" - Данные отображаются объединёнными в первой ячейке - Нужно понять существующую структуру таблицы - Планируется использовать populate_existing_table ЧТО ПОКАЗЫВАЕТ ЭТОТ ИНСТРУМЕНТ: - Точные размеры таблицы (строки × столбцы) - Координаты каждой ячейки (строка, столбец) - Текущее содержимое каждой ячейки - Индексы вставки для каждой ячейки - Границы и диапазоны таблицы КАК ЧИТАТЬ ВЫВОД: - "dimensions": "2x3" = 2 строки, 3 столбца - "position": "(0,0)" = первая строка, первый столбец - "current_content": Что на самом деле сейчас находится в каждой ячейке - "insertion_index": Куда будет вставлен новый текст в этой ячейке ИНТЕГРАЦИЯ В РАБОЧИЙ ПРОЦЕСС: 1. После создания таблицы → Используйте его, чтобы проверить структуру 2. Перед заполнением → Используйте его, чтобы спланировать формат данных 3. После неудачного заполнения → Используйте его, чтобы увидеть, что пошло не так 4. При отладке → Сравните массив данных с фактической структурой таблицы

Отлаживает структуру таблицы

Параметры
  • document_idstringобязательный

    ID документа для просмотра

  • table_indexinteger

    Какую таблицу отлаживать (0 = первая таблица, 1 = вторая и т.д.)

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

download_chat_attachmentвнешний мир

Загружает вложение из сообщения Google Chat и сохраняет его на локальный диск. В режиме stdio возвращает локальный путь к файлу для прямого доступа. В режиме HTTP возвращает временную ссылку для скачивания (действует 1 час).

Скачать вложение чата

Параметры
  • attachment_indexinteger

    Индекс вложения для загрузки, начиная с нуля (по умолчанию 0).

  • message_idstringобязательный

    Имя ресурса сообщения (например, spaces/X/messages/Y).

  • user_google_emailstringобязательный
draft_gmail_messageвнешний мир

Создает черновик письма в аккаунте Gmail пользователя. Поддерживает как новые черновики, так и черновики ответов с необязательными вложениями. Поддерживает функцию Gmail «Send As» для создания черновиков с настроенных адресов-псевдонимов. ОТЛОЖЕННАЯ ОТПРАВКА НЕДОСТУПНА. REST API Gmail не предоставляет параметра времени отправки; функция «Schedule send» доступна только в веб-интерфейсе, и через API нельзя поместить сообщение в папку Scheduled. Не утверждайте, что сообщение было запланировано. Чтобы доставить сообщение в выбранное время, создайте черновик с помощью draft_gmail_message. Внешний планировщик должен сохранить данные сообщения, чтобы затем создать и отправить новое сообщение через send_gmail_message, или вызвать users.drafts.send с ID черновика, возвращенным draft_gmail_message. Либо предложите пользователю запланировать отправку черновика в интерфейсе Gmail.

Создаёт черновик сообщения Gmail.

Параметры
  • attachmentsobject[]

    Необязательный список вложений. Каждый элемент может быть: 'url' (получить по URL — работает с URL вложений MCP из get_drive_file_download_url / get_gmail_attachment_content), ЛИБО 'path' (путь к файлу, кодируется автоматически), ЛИБО 'content' (стандартный base64, не urlsafe) + 'filename'. Необязательный 'mime_type'. Необязательный 'content_id' (строка) делает вложение встроенным: оно попадает в часть multipart/related с Content-ID: <content_id> и Content-Disposition: inline, и HTML-тело может ссылаться на него через <img src="cid:<content_id>"> (RFC 2392). Без content_id вложение — обычное multipart/mixed.

  • bccstring

    Необязательный адрес электронной почты для скрытой копии.

  • bodystringобязательный

    Тело письма (простой текст).

  • body_formatenum

    Формат тела письма. Используйте 'plain' для обычного текста или 'html' для HTML-содержимого.

  • ccstring

    Необязательный адрес электронной почты для копии.

  • from_emailstring

    Необязательный псевдоним адреса электронной почты «Send As». Должен быть настроен в настройках Gmail (Settings > Accounts > Send mail as). Если не указан, использутся адрес Send As по умолчанию для аккаунта; если Gmail не возвращает подходящую запись Send-As или доступ к настройкам не авторизован, используется email аутентифицированного пользователя.

  • from_namestring

    Необязательное отображаемое имя отправителя (например, 'Peter Hartree'). Если оно указано, заголовок From будет отформатирован как 'Name <email>'.

  • include_signatureboolean

    Определяет, следует ли добавлять подпись Gmail из раздела «Настройки» > «Подпись», если она доступна. По умолчанию — true.

  • in_reply_tostring

    Необязательный RFC Message-ID для явного ответа на конкретное сообщение (например, 'message123@gmail.com'). Опустите, чтобы ответить на последнее подходящее сообщение в thread_id.

  • quote_originalboolean

    Определяет, нужно ли включать исходное сообщение в качестве цитируемого ответа. Действует только при указанном thread_id. По умолчанию — false.

  • referencesstring

    Необязательная цепочка предков Message-ID. Обычно опускается, когда указан thread_id; сервер выводит цепочку через выбранную цель ответа.

  • subjectstringобязательный

    Тема письма.

  • thread_idstring

    Необязательный ID ветки Gmail, в которой нужно ответить. Когда параметр in_reply_to опущен, ответ отправляется на последнее сообщение, не являющееся черновиком и не находящееся в корзине, с RFC-идентификатором сообщения.

  • tostring

    Необязательный email получателя.

  • user_google_emailstringобязательный

    Адрес Gmail пользователя. Требуется для аутентификации.

export_doc_to_pdfвнешний мир

Экспортирует документ Google Doc в формат PDF и сохраняет его в Google Drive.

Экспортирует документ в PDF.

Параметры
  • document_idstringобязательный

    ID документа Google для экспорта

  • folder_idstring

    Идентификатор папки Drive для сохранения PDF (необязательно — если не указано, сохраняется в корне)

  • pdf_filenamestring

    Название для PDF-файла (необязательно — если не указано, используется исходное название + «_PDF»)

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

find_and_replace_docвнешний мир

Находит и заменяет текст во всём Google Doc. Расчёт индексов не требуется. Это самый безопасный способ обновить конкретный текст в документе, поскольку не требует знания индексов. Используйте этот инструмент, когда нужно: - Заменить текст-заполнитель (например, {{TITLE}}) реальным содержимым - Обновить конкретные слова или фразы во всём документе - Вносить целевые изменения в текст без риска ошибок индексов Для создания документов с нуля рассмотрите вставку текста с уникальными заполнителями через batch_update_doc, а затем замену их с помощью этого инструмента.

Find and Replace Doc

Параметры
  • document_idstringобязательный

    Идентификатор документа для обновления.

  • find_textstringобязательный

    Текст для поиска

  • match_caseboolean

    Учитывать ли регистр букв точно

  • replace_textstringобязательный

    Текст для замены

  • tab_idstring

    Необязательный ID целевой вкладки.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

format_sheet_rangeвнешний мир

Применяет форматирование к диапазону: цвета, числовые форматы, перенос текста, выравнивание и стили текста. Цвета принимают hex-строки (#RRGGBB). Числовые форматы соответствуют типам Sheets (например, NUMBER, CURRENCY, DATE, PERCENT). Если имя листа не указано, используется первый лист.

Форматировать диапазон листа

Параметры
  • background_colorstring

    Шестнадцатеричный цвет фона (например, "#FFEECC").

  • boldboolean

    Применять ли полужирное форматирование.

  • font_sizeinteger

    Размер шрифта в пунктах.

  • horizontal_alignmentstring

    Горизонтальное выравнивание текста - LEFT, CENTER или RIGHT.

  • italicboolean

    Применять ли курсивное форматирование?

  • number_format_patternstring

    Настраиваемый шаблон для формата числа.

  • number_format_typestring

    Тип числового формата в Таблицах (например, «ДАТА»).

  • range_namestringобязательный

    Диапазон в стиле A1 (необязательно с именем листа). Обязательно.

  • spreadsheet_idstringобязательный

    Идентификатор электронной таблицы. Обязателен.

  • text_colorstring

    Цвет текста в шестнадцатеричном формате (например, "#000000").

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

  • vertical_alignmentstring

    Вертикальное выравнивание текста — TOP, MIDDLE или BOTTOM.

  • wrap_strategystring

    Стратегия переноса текста — WRAP (переносить текст в пределах ячейки), CLIP (обрезать текст по границе ячейки) или OVERFLOW_CELL (разрешить тексту выходить за пределы ячейки в соседние пустые ячейки).

generate_trigger_codeтолько чтениеидемпотентный

Генерирует код Apps Script для создания триггеров. API Apps Script не может создавать триггеры напрямую, их нужно создавать из самого Apps Script. Этот инструмент генерирует нужный вам код. Чтобы вывести список или удалить существующие триггеры, не открывая редактор, используйте manage_script_trigger (action="list" / action="delete") вместо этого.

Генерирует код триггера

Параметры
  • function_namestringобязательный

    Функция, которая выполняется при срабатывании триггера (например, "sendDailyReport")

  • schedulestring

    Детали расписания (в зависимости от trigger_type): - Для time_minutes: «1», «5», «10», «15» или «30» - Для time_hours: «1», «2», «4», «6», «8» или «12» - Для time_daily: час в формате «0»–«23» (например, «9» для 9 утра) - Для time_weekly: «MONDAY», «TUESDAY» и т. д. - Для простых триггеров (on_open, on_edit): не требуется

  • trigger_typestringобязательный

    Тип триггера. Один из: - "time_minutes" (запуск каждые N минут: 1, 5, 10, 15, 30) - "time_hours" (запуск каждые N часов: 1, 2, 4, 6, 8, 12) - "time_daily" (ежедневный запуск в определённый час: 0-23) - "time_weekly" (еженедельный запуск в определённый день) - "on_open" (простой триггер - срабатывает при открытии документа) - "on_edit" (простой триггер - срабатывает при редактировании пользователем) - "on_form_submit" (срабатывает при отправке формы) - "on_change" (срабатывает при изменении содержимого)

get_contactтолько чтениеидемпотентныйвнешний мир

Получает подробную информацию о конкретном контакте.

Get Contact

Параметры
  • contact_idstringобязательный

    Идентификатор контакта (например, "c1234567890" или полное имя ресурса "people/c1234567890").

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_contact_groupтолько чтениеидемпотентныйвнешний мир

Получить сведения о конкретной группе контактов, включая её участников.

Получить группу контактов

Параметры
  • group_idstringобязательный

    Идентификатор контактной группы.

  • max_membersinteger

    Максимум возвращаемых элементов (по умолчанию: 100, максимум: 1000).

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_doc_as_markdownтолько чтениеидемпотентныйвнешний мир

Читает Google Doc и возвращает его в виде чистого Markdown с опциональным контекстом комментариев. В отличие от get_doc_content, который возвращает обычный текст, этот инструмент сохраняет форматирование документа как Markdown: заголовки, жирный/курсив/зачёркнутый текст, ссылки, фрагменты кода, упорядоченные/неупорядоченные списки с вложенностью и таблицы. Когда комментарии включены (по умолчанию), якорный текст каждого комментария, конкретный текст, к которому был прикреплён комментарий, сохраняется, что даёт полный контекст для обсуждения.

Получает документ в формате Markdown

Параметры
  • comment_modestring

    Как отображать комментарии: - "inline": ссылки в стиле сносок, размещённые в месте якорного текста (по умолчанию) - "appendix": все комментарии, сгруппированные внизу, с якорным текстом, оформленным как цитата - "none": комментарии не включаются

  • document_idstringобязательный

    ID документа Google (или полный URL)

  • include_commentsboolean

    Включать ли комментарии (по умолчанию: True)

  • include_resolvedboolean

    Включать ли разрешённые комментарии (по умолчанию: False)

  • suggestions_view_modestring

    Как отображать предложения в возвращаемом содержимом: - "DEFAULT_FOR_CURRENT_ACCESS": по умолчанию, в зависимости от уровня доступа пользователя - "SUGGESTIONS_INLINE": предлагаемые изменения отображаются прямо в документе - "PREVIEW_SUGGESTIONS_ACCEPTED": предпросмотр так, будто все предложения приняты - "PREVIEW_WITHOUT_SUGGESTIONS": предпросмотр так, будто все предложения отклонены

  • tab_idstring

    Необязательный идентификатор одной вкладки для чтения (из inspect_doc_structure). Когда он указан, отображается только содержимое этой вкладки, без её дочерних вкладок и без заголовка вкладки. Когда он опущен, отображаются все вкладки.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

get_doc_contentтолько чтениеидемпотентныйвнешний мир

Получает содержимое Google Doc или файла на Drive (например, .docx) по идентификатору document_id. - Нативные Google Docs: получает содержимое через Docs API. - Офисные файлы (.docx и т. д.), хранящиеся на Drive: загружает через Drive API и извлекает текст. По умолчанию текст нативных Google Docs выровнен по индексам документа: пустые абзацы сохраняются, а каждый нетекстовый элемент, занимающий индекс (встроенный объект, разрыв страницы, ссылка на сноску и т. д.), отображается как один заполнитель U+FFFC на индекс. Тело документа начинается с индекса 1, поэтому смещение n в тексте, следующем за "--- CONTENT ---", соответствует индексу документа n + 1, и этот индекс можно напрямую передавать в format_text или delete_text. Таблицы и документы с несколькими вкладками чередуют разделители, поэтому выравнивание сохраняется до первой таблицы или заголовка вкладки. Установите preserve_context=True, чтобы получать читаемые адреса ссылок, внутренние цели, значения смарт-чипов, границы таблиц, верхние и нижние колонтитулы, сноски и контекст объектов, который предоставляет Docs API. Это обычный текст, а не Markdown, и его смещения нельзя использовать в качестве индексов редактирования документа. Комментарии, история изменений, точное визуальное расположение и детали чипов, скрытые API, не включаются. Используйте get_doc_as_markdown для форматирования или комментариев.

Get Doc Content

Параметры
  • document_idstringобязательный

    ID документа Google (или полный URL)

  • preserve_contextboolean

    Включает читаемые семантические аннотации для нативных Docs. По умолчанию False, чтобы сохранить выравнивание индексов. Извлечение из Office не затрагивается. С tab_id отображается только выбранная вкладка.

  • suggestions_view_modestring

    Как отображать предложения в возвращаемом содержимом: - "DEFAULT_FOR_CURRENT_ACCESS": по умолчанию, в зависимости от уровня доступа пользователя - "SUGGESTIONS_INLINE": предлагаемые изменения отображаются прямо в документе - "PREVIEW_SUGGESTIONS_ACCEPTED": предпросмотр так, будто все предложения приняты - "PREVIEW_WITHOUT_SUGGESTIONS": предпросмотр так, будто все предложения отклонены

  • tab_idstring

    Необязательный ID одной вкладки для чтения (из inspect_doc_structure). Если он задан, возвращается содержимое только этой вкладки без разделителя вкладок, так что вывод по умолчанию остаётся выровненным по индексу с этой вкладкой. Если его не указать, возвращаются все вкладки с маркерами "--- TAB: ... ---".

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

get_drive_file_contentтолько чтениеидемпотентныйвнешний мир

Извлекает содержимое конкретного файла Google Drive по идентификатору, поддерживает файлы в общих дисках. • Нативные Google Docs, Sheets, Slides → экспортируются как текст / CSV. • Office-файлы (.docx, .xlsx, .pptx) → распаковываются и разбираются через std-lib для извлечения читаемого текста. • PDF → текст извлекается с помощью pypdf, если возможно; для сканов и PDF, содержащих только изображения, выдаётся подсказка для скачивания. • Изображения → возвращаются в base64 с MIME-метаданными для мультимодальных клиентов. • Любой другой файл → скачивается; пытается декодировать UTF-8, иначе помечается как бинарный.

Получает содержимое файла Drive

Параметры
  • file_idstringобязательный

    ID файла Drive.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя.

get_drive_file_download_urlтолько чтениеидемпотентныйвнешний мир

Скачивает файл Google Drive и сохраняет его на локальный диск. В режиме stdio возвращает локальный путь к файлу для прямого доступа. В режиме HTTP возвращает временный URL для скачивания (действителен 1 час). В режиме без состояния (без хранения файлов) возвращает сам файл как встроенный ресурс, размером до WORKSPACE_MCP_STATELESS_INLINE_MAX_BYTES (по умолчанию 10 МиБ, и не более WORKSPACE_MCP_MAX_FILE_BYTES, если он задан). Для нативных файлов Google (Docs, Sheets, Slides) экспортирует в полезный формат: - Google Docs -> PDF (по умолчанию) или DOCX, если export_format='docx' - Google Sheets -> XLSX (по умолчанию), PDF, если export_format='pdf', или CSV, если export_format='csv' - Google Slides -> PDF (по умолчанию) или PPTX, если export_format='pptx' Для остальных файлов скачивает исходный формат файла.

Получает URL загрузки файла Drive.

Параметры
  • export_formatstring

    Необязательный формат экспорта для нативных файлов Google. Варианты: 'pdf', 'docx', 'xlsx', 'csv', 'pptx'. Если не указан, используются разумные значения по умолчанию (PDF для Docs/Slides, XLSX для Sheets). Для Sheets: поддерживает 'csv', 'pdf' или 'xlsx' (по умолчанию).

  • file_idstringобязательный

    Идентификатор файла Google Drive для скачивания.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_drive_file_permissionsтолько чтениеидемпотентныйвнешний мир

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

Получает разрешения файла Drive

Параметры
  • file_idstringобязательный

    Идентификатор файла, для которого нужно проверить права доступа.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_drive_shareable_linkтолько чтениеидемпотентныйвнешний мир

Получает ссылку для общего доступа к файлу или папке Google Drive.

Получает общую ссылку на Drive

Параметры
  • file_idstringобязательный

    ID файла или папки, для которой нужно получить общую ссылку. Обязательно.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_eventsтолько чтениеидемпотентныйвнешний мир

Извлекает события из указанного календаря Google. Можно получить одно событие по ID или несколько событий в заданном временном диапазоне. Можно также искать события по ключевому слову, указав необязательный параметр "query".

Получить события

Параметры
  • calendar_idstring

    Идентификатор календаря для запроса. Используйте 'primary' для основного календаря пользователя. По умолчанию используется 'primary'. Идентификаторы календарей можно получить с помощью list_calendars.

  • detailedboolean

    Возвращает ли подробную информацию о событии, включая описание, местоположение, цвет (colorId), участников и детали участников (статус ответа, организатор, дополнительные флаги). Повторяющиеся экземпляры также сообщают идентификатор родительской серии, необходимый для редактирования всей серии; повторяющиеся серии сообщают свои исходные правила повторения RFC5545; а события, не являющиеся обычными подтверждёнными встречами, сообщают свой тип события (outOfOffice, workingLocation, focusTime) и статус. По умолчанию — False.

  • event_idstring

    Идентификатор конкретного события для получения. Если указан, возвращает только это событие и игнорирует параметры фильтрации по времени.

  • include_attachmentsboolean

    Указывает, нужно ли включать информацию о вложениях в подробный вывод событий. Если задано значение True, показывает сведения о вложениях (fileId, fileUrl, mimeType, title) для событий, у которых есть вложения. Работает только при detailed=True. Установите True, когда нужно просмотреть или получить доступ к файлам, прикреплённым к событиям календаря, например к документам встреч, презентациям или другим общим файлам. По умолчанию — False.

  • max_resultsinteger

    Максимальное количество событий, возвращаемых на одной странице. По умолчанию: 25. Игнорируется, если указан event_id.

  • page_tokenstring

    Токен для следующей страницы, полученный из предыдущего ответа. Когда single_events=True, также передавайте time_min из поля Pagination ответа как time_min, даже если он не был указан при первом вызове. Все остальные параметры запроса оставьте без изменений. Игнорируется, если указан event_id.

  • querystring

    Ключевое слово для поиска по полям событий (summary, description, location). Игнорируется, если указан event_id.

  • single_eventsboolean

    Разворачивает повторяющиеся серии в отдельные экземпляры. По умолчанию установлено значение True для обратной совместимости. Установите значение False с detailed=True, чтобы получить повторяющиеся мастер-события и их точные правила повторения RFC5545 вместо определения периодичности по развернутым экземплярам.

  • time_maxstring

    Конец временного диапазона (исключая) в формате RFC3339. Если параметр не указан, учитываются события, начиная с time_min и далее (до max_results). Игнорируется, если указан event_id.

  • time_minstring
  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_formтолько чтениеидемпотентныйвнешний мир

Получить форму.

Получить форму

Параметры
  • form_idstringобязательный

    Идентификатор формы, которую нужно получить.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_form_responseтолько чтениеидемпотентныйвнешний мир

Получить один ответ из формы.

Получить ответ формы

Параметры
  • form_idstringобязательный

    Идентификатор формы.

  • response_idstringобязательный

    Идентификатор ответа для получения.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_gmail_attachment_contentвнешний мир

Скачивает вложение из письма и сохраняет на локальный диск. В режиме stdio возвращает локальный путь к файлу для прямого доступа. В режиме HTTP возвращает временный URL для скачивания (действителен 1 час). Может повторно запросить метаданные письма, чтобы определить имя файла и MIME-тип.

Получить содержимое вложения Gmail

Параметры
  • attachment_idstringобязательный

    Идентификатор вложения, которое нужно скачать.

  • attachment_indexinteger

    Позиция вложения с отсчётом от нуля из ответа message-content. Когда лимит включён, это позволяет серверу безопасно сопоставлять обновлённые идентификаторы вложений Gmail с текущими метаданными перед скачиванием.

  • message_idstringобязательный

    Идентификатор сообщения Gmail, содержащего вложение.

  • return_base64boolean

    Когда значение равно True, полное вложение включается в ответ в виде стандартной base64-строки (в дополнение к пути к файлу или URL-адресу загрузки). Это полезно для клиентов в изолированной среде, которые не могут получить доступ к URL-адресам локального хоста или локальным путям к файлам MCP-сервера (например, для контейнерных агентов с сетевыми списками разрешений). Возвращаемая base64 использует стандартный алфавит, поэтому её можно напрямую передавать в такие инструменты, как draft_gmail_message, которые ожидают стандартную (не URL-безопасную) base64. Значение по умолчанию False сохраняет текущее поведение и размер ответа.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_gmail_message_contentтолько чтениеидемпотентныйвнешний мир

Получает полное содержимое (тему, отправителя, получателей, текст) конкретного сообщения Gmail.

Получает содержимое письма Gmail

Параметры
  • body_formatenum

    Формат вывода (применяется только когда format='full'). 'text' (по умолчанию) возвращает обычный текст (HTML преобразуется в текст как запасной вариант). 'html' возвращает исходный HTML-код как есть, без преобразований. 'raw' извлекает полное исходное MIME-сообщение и возвращает содержимое, декодированное с помощью base64url.

  • formatenum

    Формат сообщения. "full" (по умолчанию) включает тело и вложения, "metadata" - только заголовки.

  • fullboolean

    Когда значение True, возвращайте ПОЛНОЕ неусечённое сообщение: сохраняйте его в локальном хранилище и ссылайтесь на него через URL загрузки или путь к файлу вместо текста тела, либо встраивайте его в ответ, если на сервере нет файлового хранилища (режим без сохранения состояния). Используйте для сообщений, достаточно больших, чтобы достичь лимита усечения, или когда требуется точное соответствие байтов (сочетайте с body_format='raw' для экспорта в .eml).

  • message_idstringобязательный

    Уникальный идентификатор сообщения Gmail для получения.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_gmail_messages_content_batchтолько чтениеидемпотентныйвнешний мир

Извлекает содержимое нескольких писем Gmail в одном пакетном запросе. Поддерживает до 25 писем за один пакет, чтобы предотвратить исчерпание SSL-соединений.

Получает содержимое писем Gmail пакетно

Параметры
  • body_formatenum

    Формат вывода (применяется только когда format='full'). 'text' (по умолчанию) возвращает обычный текст (HTML преобразуется в текст как запасной вариант). 'html' возвращает исходный HTML-код как есть, без преобразований. 'raw' извлекает полное исходное MIME-сообщение и возвращает содержимое, декодированное с помощью base64url.

  • formatenum

    Формат сообщения. 'full' включает тело, 'metadata' только заголовки.

  • message_idsstring[]обязательный

    Список идентификаторов сообщений Gmail для получения (не более 25 за один пакет).

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_gmail_thread_contentтолько чтениеидемпотентныйвнешний мир

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

Получает содержимое цепочки Gmail

Параметры
  • body_formatenum

    Формат выходных данных тела. 'text' (по умолчанию) возвращает обычный текст (HTML преобразуется в текст как запасной вариант). 'html' возвращает исходное HTML-тело как есть, без преобразования. 'raw' извлекает полное исходное MIME-содержимое каждого сообщения и возвращает тело, декодированное из base64url.

  • include_analysisboolean

    Когда значение равно True, возвращается словарь, содержащий и отформатированное содержимое треды, и структурированный анализ владения (последний отправитель, вердикт по мячу на стороне игрока, количество сообщений от каждого отправителя, участники). По умолчанию — False, в этом случае сохраняется существующая строковая форма возвращаемого значения.

  • thread_idstringобязательный

    Уникальный идентификатор потока Gmail для получения.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_gmail_threads_content_batchтолько чтениеидемпотентныйвнешний мир

Получает содержимое нескольких цепочек писем Gmail в одном пакетном запросе. Поддерживает до 25 цепочек на пакет, чтобы предотвратить истощение SSL-соединений.

Получает содержимое цепочек Gmail пакетно.

Параметры
  • body_formatenum

    Формат выходных данных тела. 'text' (по умолчанию) возвращает обычный текст (HTML преобразуется в текст как запасной вариант). 'html' возвращает исходное HTML-тело как есть, без преобразования. 'raw' извлекает полное исходное MIME-содержимое каждого сообщения и возвращает тело, декодированное из base64url.

  • thread_idsstring[]обязательный

    Список идентификаторов потоков Gmail для получения. Функция автоматически группирует запросы в пакеты по 25.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_messagesтолько чтениеидемпотентныйвнешний мир

Извлекает сообщения из пространства Google Chat.

Получить сообщения

Параметры
  • message_filterstring

    Необязательная строка фильтра с использованием синтаксиса фильтров Chat API. Поддерживает createTime и thread.name. Примеры: 'createTime > "2026-03-18T00:00:00-03:00"' 'createTime > "2026-03-18T00:00:00-03:00" AND createTime < "2026-03-19T00:00:00-03:00"' 'thread.name = spaces/X/threads/Y'

  • order_bystring
  • page_sizeinteger
  • space_idstringобязательный
  • user_google_emailstringобязательный
get_pageтолько чтениеидемпотентныйвнешний мир

Получает сведения о конкретной странице (слайде) в презентации.

Получить страницу

Параметры
  • include_geometryboolean

    Также сообщает размещение каждого элемента - его transform (translate и scale/shear, если не identity) и собственный размер, в сырых EMU. Установите это при добавлении элементов в существующую презентацию: это единственный способ узнать поля презентации, промежутки и ширину контента, которые Slides больше нигде не раскрывает, и сообщает те же термины, которые записывает batch_update_presentation. По умолчанию False, чтобы стоимость токенов вывода по умолчанию не менялась. Таблицы также сообщают ширины столбцов, высоты строк и текст ячеек.

  • include_stylesboolean

    Также выводите стили текста: для каждого абзаца (выравнивание, отступы, интервалы, маркеры) и для каждого фрагмента с единым стилем (семейство шрифтов, насыщенность, размер, полужирный/курсив, цвет), каждый с коротким отрывком; плюс привязка к placeholder, автоподгонка, заливка и контур для фигур (fill=none / outline=none, если явно не отображается), и стили текста каждой ячейки таблицы. Появляются только явно заданные значения; всё остальное наследуется от placeholder, указанного в выводе. Используйте для проверки: единообразие шрифтов, использование цвета, выравнивание.

  • page_object_idstringобязательный

    Идентификатор объекта страницы или слайда, который нужно получить.

  • presentation_idstringобязательный

    Идентификатор презентации.

  • rawboolean

    Возвращает полный ресурс Page Slides API в формате JSON вместо сводки. Ничего не фильтруется. Используется, когда в сводке нет нужного поля. Переопределяет другие флаги.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_page_thumbnailтолько чтениеидемпотентныйвнешний мир

Генерирует URL миниатюры для конкретной страницы (слайда) в презентации.

Получить миниатюру страницы

Параметры
  • inlineboolean

    Также возвращает сам отрендеренный PNG как содержимое изображения, чтобы мультимодальный клиент мог посмотреть слайд, не запрашивая URL. URL - это недолговечная ссылка googleusercontent, до которой клиенты в песочнице или с ограничениями на исходящий трафик часто не могут добраться. Если изображение не удаётся получить, возвращается результат только с URL и примечанием об этом. По умолчанию False.

  • page_object_idstringобязательный

    Идентификатор объекта страницы/слайда.

  • presentation_idstringобязательный

    Идентификатор презентации.

  • thumbnail_sizestring

    Размер миниатюры («LARGE», «MEDIUM», «SMALL»). По умолчанию — «MEDIUM».

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_presentationтолько чтениеидемпотентныйвнешний мир

Получить подробности о презентации Google Slides.

Получить презентацию

Параметры
  • include_geometryboolean

    Также перечисляет элементы каждого слайда с их размещением - трансформацией (смещение, а также масштабирование/сдвиг, если не единичная) и собственным размером в сырых EMU. Установите этот параметр при добавлении слайдов в существующую презентацию, чтобы новые элементы могли соответствовать её установленным полям и ширине контента. По умолчанию - False.

  • include_speaker_notesboolean

    Также сообщайте заметки докладчика (презентатора) для каждого слайда и идентификатор фигуры, которая их содержит. Передавайте True, когда нужно прочитать или отредактировать заметки: этот идентификатор фигуры — единственная допустимая цель для insertText/deleteText в заметках, а batch_update_presentation записывает заметки, заменяя существующий текст фигуры новым. По умолчанию — False.

  • include_stylesboolean

    Также выводит список элементов каждого слайда с оформлением текста (см. get_page). По умолчанию: False.

  • presentation_idstringобязательный

    Идентификатор презентации для получения.

  • rawboolean

    Возвращает полный ресурс Slides API Presentation в формате JSON (слайды, макеты, образцы, заметки, каждый элемент и стиль) вместо сводки. Ничего не фильтруется, поэтому ответ может быть большим; для одного слайда лучше использовать get_page с raw=True. Переопределяет остальные флаги.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_script_activityтолько чтениеидемпотентныйвнешний мир

Читает данные об активности выполнения скриптов: недавние процессы или агрегированные метрики.

Получает действие скрипта.

Параметры
  • actionstringобязательный

    Одно из значений: "processes", "metrics".

  • metrics_granularitystring

    Гранулярность метрик - "DAILY" или "WEEKLY".

  • page_sizeinteger

    Число результатов для процессов (по умолчанию: 50).

  • script_idstring

    ID проекта скрипта (обязателен для метрик; необязателен для процессов).

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя

get_script_projectтолько чтениеидемпотентныйвнешний мир

Читает проекты Apps Script и их исходные файлы.

Получает Script Project

Параметры
  • actionstringобязательный

    Одно из значений: "list", "get".

  • file_namestring

    Необязательное имя исходного файла для get.

  • page_sizeinteger

    Количество результатов на странице для списка (по умолчанию: 50).

  • page_tokenstring

    Токен пагинации для списка (необязательно).

  • script_idstring

    ID проекта скрипта (обязателен для get).

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя

get_script_versionтолько чтениеидемпотентныйвнешний мир

Перечисляет или получает неизменяемые снимки версий скриптового проекта. Действия: - "list": Перечисляет все версии проекта. - "get": Получает одну версию. Требует version_number.

Получает версию скрипта.

Параметры
  • actionstringобязательный
  • script_idstringобязательный
  • user_google_emailstringобязательный
  • version_numberinteger
get_search_engine_infoтолько чтениеидемпотентныйвнешний мир

Получает метаданные о Programmable Search Engine.

Получает информацию о поисковом движке.

Параметры
  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_spreadsheet_infoтолько чтениеидемпотентныйвнешний мир

Получает информацию о конкретной таблице, включая её листы.

Получает информацию о таблице.

Параметры
  • spreadsheet_idstringобязательный

    ID таблицы, для которой нужно получить информацию. Обязательно.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_taskтолько чтениеидемпотентныйвнешний мир

Получить детали конкретной задачи.

Получить задачу

Параметры
  • task_idstringобязательный

    Идентификатор задачи для получения.

  • task_list_idstringобязательный

    Идентификатор списка задач, содержащего задачу.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

get_task_listтолько чтениеидемпотентныйвнешний мир

Получить сведения о конкретном списке задач.

Получить список задач

Параметры
  • task_list_idstringобязательный

    ID списка задач для получения.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

import_to_google_docвнешний мир

Импортирует файл (Markdown, DOCX, TXT, HTML, RTF, ODT) в формат Google Docs с автоматическим преобразованием. Google Drive автоматически преобразует исходный файл в собственный формат Google Docs, сохраняя форматирование: заголовки, списки, полужирный, курсив и т.д. Бинарные источники можно передавать напрямую как base64_content. На локальном сервере файл на диске также можно передать по пути (предпочтительно для пакетных операций, чтобы вызывающему коду не приходилось загружать полное содержимое файла в свой контекст).

Импортировать в Google Doc

Параметры
  • base64_contentstring

    Стандартные байты, закодированные в base64, для бинарного источника, такого как DOCX или ODT.

  • base64_sha256string

    Ожидаемый SHA-256 декодированного base64_content. Рекомендуется для проверки целостности бинарных данных.

  • contentstring

    Текстовый контент для текстовых форматов. Используйте только для коротких фрагментов или контента, уже находящегося в памяти.

  • file_namestringобязательный

    Название для нового Google Документа (расширение будет проигнорировано).

  • file_pathstring

    Локальный путь к файлу или URL вида file:// для любого поддерживаемого формата (MD, TXT, HTML, DOCX, ODT, RTF). Подходит для файлов большего размера, чем content, но file_path всё равно может загрузить файл в память или выполнить чтение без потоковой передачи. Избегайте очень больших файлов, которые могут превысить лимиты памяти или времени; для огромных файлов используйте потоковую/порционную загрузку или альтернативный API.

  • file_urlstring

    Удалённый URL для получения файла (http/https).

  • folder_idstring

    Идентификатор родительской папки. По умолчанию — 'root'.

  • source_formatstring

    Подсказка формата источника ('md', 'markdown', 'docx', 'txt', 'html', 'rtf', 'odt'). Если не указано, формат определяется автоматически по расширению файла.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

import_to_google_sheetsвнешний мир

Импортирует электронную таблицу (XLSX, XLS, ODS, CSV, TSV) в формат Google Sheets с автоматическим преобразованием. Google Диск автоматически преобразует исходную таблицу в собственный формат Google Sheets, сохраняя строки, столбцы, листы и значения. Двоичные источники можно передавать напрямую как base64_content. На локальном сервере файл на диске также можно передать по пути (предпочтительно для пакетных операций, чтобы вызывающим не приходилось загружать полное содержимое файлов в свой контекст).

Импортирует в Google Sheets

Параметры
  • base64_contentstring

    Стандартные байты в кодировке base64 для источника XLSX, XLS или ODS.

  • base64_sha256string

    Ожидаемый SHA-256 декодированного base64_content. Рекомендуется для проверки целостности бинарных данных.

  • contentstring

    Текстовое содержимое для текстовых форматов (CSV, TSV). Используйте только для коротких фрагментов или уже загруженного в память контента.

  • file_namestringобязательный

    Название для новой таблицы Google Sheets (расширение будет проигнорировано).

  • file_pathstring

    Локальный путь к файлу или URL вида file:// для любого поддерживаемого формата (XLSX, XLS, ODS, CSV, TSV). Подходит для более крупных файлов, чем параметр content, но file_path всё равно может загрузить файл в память или читать его без потоковой обработки. Избегайте очень больших файлов, которые могут превысить лимиты памяти или времени; используйте потоковую или пофрагментную загрузку либо другой API для огромных файлов.

  • file_urlstring

    Удалённый URL для загрузки таблицы (http/https).

  • folder_idstring

    Идентификатор родительской папки. По умолчанию — 'root'.

  • source_formatstring

    Подсказка исходного формата ('xlsx', 'xls', 'ods', 'csv', 'tsv'). Если не указана, определяется автоматически по расширению file_name.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

import_to_google_slidesвнешний мир

Импортирует презентацию (PPTX, PPT, ODP) в формат Google Slides с автоматическим преобразованием. Google Диск автоматически преобразует исходную презентацию в собственный формат Google Slides, сохраняя слайды, макеты, текст и изображения. Бинарные источники могут передаваться напрямую как base64_content. На локальном сервере файл на диске также можно передать по пути (предпочтительно для пакетных операций, чтобы вызывающим сторонам не нужно было загружать полное содержимое файла в свой контекст).

Импортирует в Google Slides

Параметры
  • base64_contentstring

    Стандартные байты в кодировке base64 для источника PPTX или ODP.

  • base64_sha256string

    Ожидаемый SHA-256 декодированного base64_content. Рекомендуется для проверки целостности бинарных данных.

  • file_namestringобязательный

    Название для новой презентации Google Slides (расширение будет проигнорировано).

  • file_pathstring

    Локальный путь к файлу или URL вида file:// для любого поддерживаемого формата (PPTX, PPT, ODP). Подходит для файлов большего размера, чем при передаче содержимого, но путь к файлу всё равно может загружать файл в память или выполнять чтение без потоковой передачи. Избегайте очень больших файлов, которые могут превысить лимиты памяти или времени; для огромных файлов используйте потоковую или фрагментированную загрузку либо альтернативный API.

  • file_urlstring

    Удалённый URL для загрузки презентации (http/https).

  • folder_idstring

    Идентификатор родительской папки. По умолчанию — 'root'.

  • source_formatstring

    Подсказка формата источника ('pptx', 'ppt', 'odp'). Если не указано, автоматически определяется по расширению file_name.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

insert_doc_elementsвнешний мир

Вставляет структурные элементы, такие как таблицы, списки или разрывы страниц, в документ Google Docs.

Вставляет элементы документа

Параметры
  • columnsinteger

    Количество столбцов для таблицы (обязательно для таблицы)

  • document_idstringобязательный

    Идентификатор документа для обновления.

  • element_typestringобязательный

    Тип вставляемого элемента («table», «list», «page_break»)

  • indexintegerобязательный

    Позиция для вставки элемента (с нуля)

  • list_typestring

    Тип списка ("UNORDERED", "ORDERED") (обязательно для списка)

  • rowsinteger

    Количество строк для таблицы (обязательно для таблицы)

  • textstring

    Начальное текстовое содержимое для элементов списка.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

insert_doc_imageвнешний мир

Вставляет изображение в Google Doc из Drive или по URL.

Вставляет изображение документа.

Параметры
  • document_idstringобязательный

    Идентификатор документа для обновления.

  • heightinteger

    Высота изображения в пунктах (необязательно)

  • image_sourcestringобязательный

    ID файла на Диске или публичный URL изображения

  • indexintegerобязательный

    Позиция для вставки изображения (с нуля)

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

  • widthinteger

    Ширина изображения в пунктах (необязательно)

inspect_doc_structureтолько чтениеидемпотентныйвнешний мир

Важный инструмент для поиска безопасных точек вставки и понимания структуры документа. ИСПОЛЬЗУЙТЕ ЭТО ДЛЯ: - Поиска правильного индекса для вставки таблицы - Понимания структуры документа перед внесением изменений - Определения местоположения существующих таблиц и их позиций - Получения статистики документа и информации о сложности - Проверки структуры конкретных вкладок КРИТИЧЕСКИ ВАЖНО ДЛЯ ОПЕРАЦИЙ С ТАБЛИЦАМИ: ВСЕГДА вызывайте это ПЕРЕД созданием таблиц, чтобы получить безопасный индекс вставки. ЧТО ПОКАЗЫВАЕТ РЕЗУЛЬТАТ: - total_elements: количество элементов документа - total_length: максимальный безопасный индекс для вставки - tables: количество существующих таблиц - table_details: позиция и размеры каждой таблицы - headers / footers: реальные идентификаторы сегментов и предпросмотр для редактирования верхних и нижних колонтитулов - tabs: список доступных вкладок в документе (если не указан tab_id) - empty_paragraphs: количество только переносов строк, без учёта существующих/предложенных якорей объектов - empty_paragraph_ranges: начальные/конечные границы, не более 100 - empty_paragraph_ranges_truncated: были ли пропущены диапазоны - last_paragraph: is_list_item и is_empty, или null, если нет абзацев тела документа Статистика абзацев охватывает абзацы тела верхнего уровня и отображается на верхнем уровне в базовом режиме или в разделе «statistics» в подробном режиме. Диапазоны могут включать обязательные пустые абзацы. Перед очисткой используйте detailed=true, чтобы проверить соседние элементы, форматирование и якоря объектов. Сохраняйте завершающий перенос строки и переносы строк перед таблицами, оглавлениями или разрывами разделов. Конечный диапазон имеет end == total_length и может быть опущен при усечении. ПОРЯДОК ДЕЙСТВИЙ ДЛЯ ВСТАВКИ ТАБЛИЦЫ: Шаг 1: вызовите эту функцию Шаг 2: обратите внимание на значение «total_length» Шаг 3: используйте индекс < total_length для вставки таблицы Шаг 4: создайте таблицу ПОРЯДОК ДЕЙСТВИЙ ДЛЯ ФОРМАТИРОВАНИЯ: После вставки всего текста через batch_update_doc с параметром end_of_segment=true вызовите этот инструмент с detailed=true, чтобы получить точные start_index и end_index для каждого абзаца. Используйте эти индексы напрямую в операциях format_text и update_paragraph_style во втором…

Проверяет структуру документа

Параметры
  • detailedboolean

    Возвращать ли подробную информацию о структуре

  • document_idstringобязательный

    ID документа для просмотра

  • preview_charsinteger

    Максимальное количество символов предпросмотра текста абзаца, заголовка и нижнего колонтитула. Передайте 0 или None, чтобы получить полный текст; он нужен для поиска токена внутри абзаца длиннее стандартных 100 символов.

  • tab_idstring

    Необязательный ID вкладки для проверки. Если не указан, проверяется основной документ.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

list_calendarsтолько чтениеидемпотентныйвнешний мир

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

Показать календари

Параметры
  • max_resultsinteger

    Максимальное количество календарей, возвращаемых на одной странице. Если не указано, используется значение по умолчанию API.

  • page_tokenstring

    Токен для следующей страницы, взятый из предыдущего ответа.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_contact_groupsтолько чтениеидемпотентныйвнешний мир

Вывести список контактных групп (меток) для пользователя.

Вывести список групп контактов

Параметры
  • page_sizeinteger

    Максимальное количество групп для возврата (по умолчанию: 100, максимум: 1000).

  • page_tokenstring

    Токен для пагинации.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_contactsтолько чтениеидемпотентныйвнешний мир

Выводит список контактов для текущего пользователя.

Список контактов

Параметры
  • page_sizeinteger

    Максимальное количество возвращаемых контактов (по умолчанию: 100, максимум: 1000).

  • page_tokenstring

    Токен для пагинации.

  • sort_orderstring

    Порядок сортировки: "LAST_MODIFIED_ASCENDING", "LAST_MODIFIED_DESCENDING", "FIRST_NAME_ASCENDING" или "LAST_NAME_ASCENDING".

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_docs_in_folderтолько чтениеидемпотентныйвнешний мир

Перечисляет документы Google Docs в конкретной папке Drive.

Вывести список документов в папке

Параметры
  • folder_idstring

    Идентификатор папки на Диске для вывода списка. По умолчанию - 'root'.

  • page_sizeinteger

    Максимальное количество документов для возврата. По умолчанию 100.

  • page_tokenstring

    Токен страницы из nextPageToken предыдущего ответа для получения следующей страницы результатов.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя.

list_document_commentsтолько чтениеидемпотентныйвнешний мир

Перечисляет все комментарии из Google-документа (опционально max_comments для ограничения результатов).

Перечисляет комментарии документа

Параметры
  • document_idstringобязательный
  • max_commentsinteger
  • user_google_emailstringобязательный
list_drive_itemsтолько чтениеидемпотентныйвнешний мир

Перечисляет файлы/папки или контейнеры общих дисков с поддержкой общих дисков. Если указан drive_id, перечисляет элементы внутри этого общего диска. folder_id при этом задаётся относительно этого диска (или используйте drive_id как folder_id для корня). Если drive_id не указан, перечисляет элементы из "My Drive" пользователя и доступных общих дисков (если include_items_from_all_drives равно True). Установите resource_type в "shared_drives", чтобы перечислить контейнеры общих дисков вместо содержимого папок.

Перечисляет элементы Drive

Параметры
  • corporastring

    Корпус для запроса ('user', 'drive', 'allDrives'). Если задан drive_id, а corpora имеет значение None, используется 'drive'. Если corpora имеет значение None и drive_id не задан, используется 'allDrives', когда include_items_from_all_drives имеет значение True.

  • detailedboolean

    Определяет, включать ли размер, время изменения и ссылку в результаты. По умолчанию — True.

  • drive_idstring

    ID общего диска. Если указан, список ограничивается этим диском.

  • file_typestring

    Ограничивает результаты по конкретному типу файла. Принимает понятное название ('folder', 'document'/'doc', 'spreadsheet'/'sheet', 'presentation'/'slides', 'form', 'drawing', 'pdf', 'shortcut', 'script', 'site', 'jam'/'jamboard') или любую строку с сырым MIME-типом (например, 'application/pdf'). По умолчанию — None (все типы).

  • folder_idstring

    Идентификатор папки Google Диска. По умолчанию — 'root'. Для общего диска это может быть идентификатор общего диска, чтобы перечислить его содержимое, или идентификатор папки внутри этого общего диска.

  • include_items_from_all_drivesboolean

    Следует ли включать элементы из всех доступных общих дисков, если drive_id не задан. По умолчанию — True.

  • include_organizersboolean

    Когда resource_type="shared_drives", включает субъектов с ролью организатора. Это стоит одного дополнительного вызова API permissions.list на каждый возвращённый общий диск. По умолчанию — False.

  • order_bystring

    Порядок сортировки. Список ключей сортировки через запятую с необязательным модификатором 'desc'. Допустимые ключи: 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'. Пример: 'modifiedTime desc' или 'folder,modifiedTime desc,name'. По умолчанию — None (стандартный порядок сортировки Drive API).

  • page_sizeinteger

    Максимальное количество элементов для возврата. По умолчанию — 100.

  • page_tokenstring

    Токен страницы из nextPageToken предыдущего ответа для получения следующей страницы результатов.

  • querystring

    Запрос к общему диску, который используется только при resource_type="shared_drives", например "имя содержит 'Engineering'".

  • resource_typestring

    Что перечислять. Используйте "items" для содержимого папки или "shared_drives" для контейнеров общих дисков. По умолчанию — "items".

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_form_responsesтолько чтениеидемпотентныйвнешний мир

Вывести ответы формы.

Список ответов формы

Параметры
  • form_idstringобязательный

    Идентификатор формы.

  • page_sizeinteger

    Максимальное количество возвращаемых ответов. По умолчанию — 10.

  • page_tokenstring

    Токен для получения следующей страницы результатов.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_gmail_filtersтолько чтениеидемпотентныйвнешний мир

Перечисляет все фильтры Gmail, настроенные в почтовом ящике пользователя.

Список фильтров Gmail

Параметры
  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_gmail_labelsтолько чтениеидемпотентныйвнешний мир

Перечисляет метки в учетной записи Gmail пользователя.

Выводит список меток Gmail

Параметры
  • compactboolean

    Возвращает минимальный JSON {"count", "labels": [{"id", "name"}]} отсортированный по имени, вместо форматированного текстового списка. Для вызывающих, которые парсят результат, например, при обновлении кэша меток.

  • include_systemboolean

    Включает системные метки Gmail (INBOX, SENT, ...). Устанавливает значение False, чтобы возвращать только пользовательские метки.

  • prefixstring

    Возвращает только те метки, чьи имена начинаются с этой точной (с учётом регистра) строки. users.labels.list не поддерживает фильтрацию, поэтому здесь получается полный список и сужается уже он: это уменьшает то, что получает вызывающий код, а не сам API-запрос.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_presentation_commentsтолько чтениеидемпотентныйвнешний мир

Вывести список всех комментариев из Google Presentation (опциональный max_comments для ограничения количества результатов).

Список комментариев презентации

Параметры
  • max_commentsinteger
  • presentation_idstringобязательный
  • user_google_emailstringобязательный
list_script_deploymentsтолько чтениеидемпотентныйвнешний мир

Выводит список развертываний для проекта Apps Script.

Перечисляет развертывания скриптов.

Параметры
  • script_idstringобязательный
  • user_google_emailstringобязательный
list_sheet_tablesтолько чтениеидемпотентныйвнешний мир

Выводит список всех структурированных таблиц в электронной таблице с их ID, названиями, диапазонами и информацией о столбцах. Используйте это, чтобы найти ID таблиц для append_table_rows.

Список таблиц листа

Параметры
  • spreadsheet_idstringобязательный

    Идентификатор электронной таблицы. Обязателен.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_spacesтолько чтениеидемпотентныйвнешний мир

Перечисляет пространства Google Chat (комнаты и личные сообщения), доступные пользователю. Возвращает: str: Отформатированный список пространств Google Chat, доступных пользователю.

Список пространств

Параметры
  • page_sizeinteger
  • space_typestring
  • user_google_emailstringобязательный
list_spreadsheet_commentsтолько чтениеидемпотентныйвнешний мир

Выводит список всех комментариев из Google Spreadsheet (опционально max_comments, чтобы ограничить количество результатов).

Выводит список комментариев таблицы

Параметры
  • max_commentsinteger
  • spreadsheet_idstringобязательный
  • user_google_emailstringобязательный
list_spreadsheetsтолько чтениеидемпотентныйвнешний мир

Перечисляет таблицы из Google Диска, к которым у пользователя есть доступ.

Выводит список электронных таблиц

Параметры
  • corporastring

    Корпус для поиска ('user', 'domain', 'drive', 'allDrives'). По умолчанию принимает значение 'drive', если задан drive_id, иначе 'allDrives'.

  • drive_idstring

    ID общего диска для поиска.

  • max_resultsinteger

    Максимальное количество возвращаемых таблиц. По умолчанию: 25.

  • page_tokenstring

    Токен страницы из nextPageToken предыдущего ответа для получения следующей страницы результатов.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_task_listsтолько чтениеидемпотентныйвнешний мир

Вывести все списки задач для пользователя.

Вывести список списков задач

Параметры
  • max_resultsinteger

    Максимальное количество списков задач для возврата (по умолчанию: 1000, максимум: 1000).

  • page_tokenstring

    Токен для пагинации.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

list_tasksтолько чтениеидемпотентныйвнешний мир

Вывести все задачи из указанного списка задач.

List Tasks

Параметры
  • completed_maxstring

    Верхняя граница для даты завершения (RFC 3339 timestamp).

  • completed_minstring

    Нижняя граница для даты завершения (временная метка RFC 3339).

  • due_maxstring

    Верхняя граница срока выполнения (временная метка RFC 3339).

  • due_minstring

    Нижняя граница для крайнего срока (временная метка RFC 3339).

  • max_resultsinteger

    Максимальное количество возвращаемых задач. (по умолчанию: 20, максимум: 10000).

  • page_tokenstring

    Токен для пагинации.

  • show_assignedboolean

    Включать ли назначенные задачи (по умолчанию: False).

  • show_completedboolean

    Включает ли завершённые задачи (по умолчанию: True). Обратите внимание, что show_hidden также должен быть True, чтобы показывать задачи, завершённые в собственных клиентах, таких как веб-интерфейс и мобильные приложения Google.

  • show_deletedboolean

    Включать ли удалённые задачи (по умолчанию: False).

  • show_hiddenboolean

    Включать ли скрытые задачи (по умолчанию: False).

  • task_list_idstringобязательный

    Идентификатор списка задач, из которого извлекаются задачи.

  • updated_minstring

    Нижняя граница времени последнего изменения (отметка времени RFC 3339).

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_conditional_formattingвнешний мир

Управляет правилами условного форматирования в Google Sheets. Позволяет добавлять, обновлять и удалять правила условного форматирования с помощью одного инструмента.

Управление условным форматированием

Параметры
  • actionstringобязательный

    Операция, которую нужно выполнить. Она должна быть одной из: "add", "update" или "delete".

  • background_colorstring

    Шестнадцатеричный цвет фона, который применяется, когда условие совпадает. Используется командами "add" и "update".

  • condition_typestring

    Тип условия Sheets (например, NUMBER_GREATER, TEXT_CONTAINS, DATE_BEFORE, CUSTOM_FORMULA). Обязателен для "add". Необязателен для "update" (сохраняет существующий тип, если не указан).

  • condition_valuesstring | string | integer | number[]

    Значения для условия; принимает список или JSON-строку, представляющую список. Зависит от condition_type. Используется операциями "add" и "update".

  • gradient_pointsstring | object[]

    Список (или JSON-список) точек градиента для цветовой шкалы. Если он указан, создаётся правило градиента, а логические параметры игнорируются. Используется в операциях "add" и "update".

  • range_namestring

    Диапазон в стиле A1 (опционально с именем листа). Обязателен для "add". Необязателен для "update" (сохраняет существующие диапазоны, если не указан). Не используется для "delete".

  • rule_indexinteger

    Индекс правила, начинающийся с нуля. Для "add" опционально указывает позицию вставки. Обязателен для "update" и "delete".

  • sheet_namestring

    Имя листа для поиска правила, когда range_name не указан. По умолчанию используется первый лист. Применяется в операциях "update" и "delete".

  • spreadsheet_idstringобязательный

    Идентификатор электронной таблицы. Обязателен.

  • text_colorstring

    Шестнадцатеричный цвет текста, который применяется, когда условие совпадает. Используется в 'add' и 'update'.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_contactвнешний мир

Создаёт, обновляет или удаляет контакт. Объединённый инструмент, заменяющий create_contact, update_contact и delete_contact.

Управление контактом

Параметры
  • actionenumобязательный

    Действие, которое нужно выполнить: "create", "update" или "delete".

  • addressstring

    Улица и номер дома (для создания/обновления).

  • birthdaystring

    День рождения в формате 'ГГГГ-ММ-ДД', 'ММ-ДД' (без года) или 'очистить'/'' для удаления.

  • contact_idstring

    Идентификатор контакта. Необходим для действий «обновление» и «удаление».

  • emailstring

    Устаревший адрес электронной почты. Используйте emails=[{"address":..., "type":"other"}].

  • emailsobject[]

    Список словарей email {address, type?}.

  • emails_modeenum

    Как обновлять электронные письма при значении "update": "merge" (по умолчанию), "replace" или "remove".

  • family_namestring

    Фамилия (для создания/обновления).

  • given_namestring

    Имя (для создания/обновления).

  • job_titlestring

    [УСТАРЕЛО] Должность. Используйте organizations=[{"title":...}].

  • nicknamesobject[]

    Список словарей никнеймов {value, type?}. Полезен для двуязычных контактов (например, альтернативные формы на иврите/английском). И Android-диалер, и поиск в WhatsApp индексируют никнеймы, что обеспечивает поиск между разными системами письма. Поддерживаемые типы: default, alternate, maiden_name, initials, other и т. д.

  • nicknames_modeenum

    Как обновлять никнеймы с помощью 'update': 'merge' (по умолчанию), 'replace' или 'remove'.

  • notesstring

    Дополнительные примечания (для создания/обновления).

  • organizationstring

    [УСТАРЕЛО] Название компании. Используйте organizations=[{"name":...}].

  • organizationsobject[]

    Список org-словарей {name?, title?, department?, jobDescription?, type?}.

  • organizations_modeenum

    Как обновить организации при "update": "merge" (по умолчанию), "replace" или "remove".

  • phonestring

    [УСТАРЕЛО] Один номер телефона. Используйте phones=[{"number":..., "type":"mobile"}].

  • phonesobject[]

    Список телефонных словарей {number, type?}. Поддерживаемые типы: mobile, work, home, main, workMobile, internal, other и др. Используйте type="internal" для внутренних коротких номеров АТС (например, 250, 301). Номер хранится отдельно, без префикса +, и отображается как "Internal: 250".

  • phones_modeenum

    Как обновить телефоны при "update": "merge" (по умолчанию), "replace" или "remove". merge = чтение-изменение-запись с дедупликацией по canonicalForm/нормализованному значению. replace = перезапись всех телефонов предоставленным списком. remove = удаление телефонов, совпадающих с предоставленными номерами.

  • relationsobject[]

    Список словарей отношений {person, type?}. Поддерживаемые типы: spouse, child, parent, friend, manager, assistant и др.

  • relations_modeenum

    Как обновить связи в параметре "update": "merge" (по умолчанию), "replace" или "remove".

  • urlsobject[]

    Список словарей URL {value, type?}. Поддерживаемые типы: homepage, blog, profile, work, ftp, reservations, other и др.

  • urls_modeenum

    Как обновлять URL-адреса с помощью параметра "update": "merge" (по умолчанию), "replace" или "remove". merge дедуплицирует по нормализованному URL (в нижнем регистре, с удалённым завершающим слэшем).

  • user_definedobject[]

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

  • user_defined_modeenum

    Как обновить пользовательские поля при "update": "merge" (по умолчанию), "replace" или "remove". merge переопределяет значение по совпадающему ключу; новые ключи добавляются.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_contact_groupвнешний мир

Создаёт, обновляет, удаляет группу контактов или изменяет её участников. Объединённый инструмент, заменяющий create_contact_group, update_contact_group, delete_contact_group и modify_contact_group_members.

Управление группой контактов

Параметры
  • actionstringобязательный

    Выполняемое действие: "create", "update", "delete" или "modify_members".

  • add_contact_idsstring[]

    Идентификаторы контактов для добавления (для «modify_members»).

  • delete_contactsboolean

    Если True и действие — «delete», также удаляет контакты в группе (по умолчанию: False).

  • group_idstring

    ID группы контактов. Требуется для действий "update", "delete" и "modify_members".

  • namestring

    Название группы. Требуется для действий «create» и «update».

  • remove_contact_idsstring[]

    Идентификаторы контактов для удаления (для "modify_members").

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_contacts_batchвнешний мир

Массовое создание, обновление или удаление контактов. Объединённый инструмент, заменяющий batch_create_contacts, batch_update_contacts и batch_delete_contacts.

Пакетное управление контактами

Параметры
  • actionenumобязательный

    Действие, которое нужно выполнить: "create", "update" или "delete".

  • contact_idsstring[]

    Список идентификаторов контактов для действия 'delete'.

  • contactsobject[]

    Список словарей контактов для действия «create». Каждый словарь может содержать: given_name, family_name, phones, emails, organizations, notes, address. Устаревшие: phone, email, organization, job_title.

  • fieldenum

    Для действия 'update' — единственное поле People API, которое обновляется во всех контактах этого пакета. Обязательное. Должно быть одним из: names, phoneNumbers, emailAddresses, organizations, nicknames, urls, userDefined, relations, biographies, addresses, birthdays. Использование одного поля на пакетный вызов предотвращает случайную потерю данных, когда объединённый updateMask перезаписывает несвязанные поля.

  • updatesobject[]

    Список словарей обновления для действия "update". Каждый словарь должен содержать contact_id и может содержать те же поля, что и contacts.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_deploymentвнешний мир

Создаёт, обновляет или удаляет развертывания Apps Script.

Управление развертыванием

Параметры
  • actionstringобязательный

    Выполняемое действие — «create», «update» или «delete»

  • deployment_idstring

    Идентификатор развертывания (требуется для обновления и удаления)

  • descriptionstring

    Описание развертывания (обязательно для создания; необязательно для обновления, если указан version_number)

  • script_idstringобязательный

    Идентификатор проекта скрипта.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя

  • version_descriptionstring

    Необязательное описание версии (только для создания)

  • version_numberinteger

    Номер версии, на которую следует перевести развёртывание (только для обновления). Требуется для перевода развёртывания на новую версию скрипта.

manage_doc_tabвнешний мир

Управляет вкладками документов: создаёт, переименовывает, удаляет или заполняет из Markdown.

Управляет вкладкой документа.

Параметры
  • actionenumобязательный

    Действие для выполнения - "create", "rename", "delete" или "populate_from_markdown"

  • document_idstringобязательный

    Идентификатор документа

  • indexinteger

    Индекс позиции для новой вкладки, отсчёт от нуля среди соседних элементов (обязателен для создания).

  • markdown_textstring

    Markdown-исходник для рендеринга (только для populate_from_markdown)

  • parent_tab_idstring

    Необязательный идентификатор родительской вкладки для вложения (только при создании)

  • replace_existingboolean

    Очищает содержимое вкладки перед вставкой Markdown (по умолчанию True)

  • tab_idstring

    Tab ID (требуется для rename, delete и populate_from_markdown; используйте inspect_doc_structure для поиска ID)

  • titlestring

    Заголовок вкладки (обязателен при создании; используется при переименовании)

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

manage_document_commentвнешний мир

Управляет комментариями в Google Документе. Действия: - create: Создает новый комментарий на уровне документа. Требует comment_content. Примечание: Drive API не может привязывать комментарии к конкретному тексту, это умеет только интерфейс Google Docs. - reply: Отвечает на комментарий. Требует comment_id и comment_content. - resolve: Разрешает комментарий. Требует comment_id.

Управляет комментарием документа

Параметры
  • actionstringобязательный
  • comment_contentstring
  • comment_idstring
  • document_idstringобязательный
  • user_google_emailstringобязательный
manage_drive_accessвнешний мир

Единый инструмент для управления правами доступа к файлам и папкам Google Drive. Поддерживает выдачу, массовую выдачу, обновление, отзыв разрешений и передачу прав владения файлами — все через единую точку входа.

Управление доступом к Drive

Параметры
  • actionstringобязательный

    Действие по управлению доступом, которое нужно выполнить. Обязательно. Одно из: - "grant": Предоставляет доступ одному пользователю, группе, домену или всем. - "grant_batch": Предоставляет доступ нескольким получателям за один вызов. - "update": Изменяет существующее разрешение (роль или срок действия). - "transfer_owner": Передаёт право владения файлом другому пользователю.

  • allow_file_discoveryboolean

    Для общих доступов 'domain'/'anyone': указывает, отображается ли файл в поиске. Используется операцией 'grant'.

  • email_messagestring

    Настраиваемое письмо для уведомлений. Используется в grant и grant_batch.

  • expiration_timestring

    Срок действия в формате RFC 3339 (например, "2025-01-15T00:00:00Z"). Используется командами "grant" и "update".

  • file_idstringобязательный

    Идентификатор файла или папки. Обязательно.

  • move_to_new_owners_rootboolean

    Перемещает файл в корень My Drive нового владельца. По умолчанию — false. Используется функцией "transfer_owner".

  • new_owner_emailstring

    Электронная почта нового владельца. Обязательно для "transfer_owner".

  • permission_idstring

    Идентификатор разрешения для изменения или удаления. Требуется для действий «обновить» и «отозвать».

  • recipientsobject[]

    Список объектов получателей для "grant_batch". Каждый должен содержать: email (str), role (str, необязательно), share_type (str, необязательно), expiration_time (str, необязательно). Для доменных шарингов используйте поле 'domain' вместо 'email'.

  • rolestring

    Роль разрешения — «reader», «commenter» или «writer». Используется в «grant» (по умолчанию «reader») и «update».

  • send_notificationboolean

    Определяет, нужно ли отправлять уведомления по электронной почте. По умолчанию - True. Используется в "grant" и "grant_batch".

  • share_typestring

    Тип общего доступа — 'user', 'group', 'domain' или 'anyone'. Используется в "grant". По умолчанию — 'user'.

  • share_withstring

    Адрес электронной почты (пользователь/группа), имя домена (домен) или опустите для «anyone». Используется в «grant».

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_eventвнешний мир

Управляет событиями календаря. Поддерживает создание, обновление, удаление и RSVP.

Управляет событием

Параметры
  • actionstringобязательный

    Выполняемое действие - "create", "update", "delete" или "rsvp".

  • add_google_meetboolean

    Добавлять или удалять встроенную Google Meet.

  • attachmentsstring[]

    Список URL-адресов или идентификаторов файлов Google Drive для прикрепления. При action="update" это заменяет существующие вложения события, а не добавляет к ним, в соответствии с семантикой метода patch в Calendar API.

  • attendeesstring | object[]

    Адреса электронной почты участников, объекты участников (например, {"email": ..., "responseStatus": "accepted"}) или их сочетание.

  • calendar_idstring

    Идентификатор календаря (по умолчанию: 'primary').

  • color_idstring

    ID цвета события (1-11, только при обновлении).

  • conference_dataobject

    Сырые данные conferenceData из Google Calendar для подключения сторонней конференции (Zoom/Webex/Teams аддон). Используйте это для полного контроля; взаимоисключающе с параметрами conference_provider и add_google_meet. Только для создания и обновления.

  • conference_idstring

    Необязательный идентификатор конференции/встречи на стороне провайдера.

  • conference_passcodestring

    Необязательный код доступа для сторонней конференции.

  • conference_providerstring

    Вспомогательная функция более высокого уровня: имя стороннего провайдера (например, "zoom", "webex", "teams"). Требует conference_uri. MCP создаёт блок addOn conferenceData внутренне. (только для создания/обновления)

  • conference_uristring

    Ссылка для подключения к сторонней конференции (например, "https://zoom.us/j/123456789"). Обязательна, когда задан conference_provider.

  • descriptionstring

    Описание события.

  • end_timestring

    Время окончания (обязательно при создании). Смещение UTC в формате RFC3339 задаёт точный момент времени и сохраняется. Если смещения нет, укажите end_timezone или timezone. Конечные даты для событий на весь день не включаются.

  • end_timezonestring

    Часовой пояс IANA только для конечной границы, переопределяющий timezone. См. start_timezone.

  • event_idstring

    Идентификатор события (требуется для обновления и удаления).

  • guests_can_invite_othersboolean

    Могут ли участники приглашать других.

  • guests_can_modifyboolean

    Могут ли участники вносить изменения.

  • guests_can_see_other_guestsboolean

    Могут ли участники видеть других гостей.

  • locationstring

    Место проведения мероприятия.

  • recurrencestring[]

    Правила повторения RFC5545 для повторяющегося события, например ["RRULE:FREQ=WEEKLY;COUNT=10"].

  • remindersstring | object[]

    Пользовательские объекты напоминаний.

  • responsestring

    Ответ RSVP — «accepted», «declined», «tentative» или «needsAction» (только для действия rsvp).

  • rsvp_commentstring

    Необязательное сообщение для включения в ответ RSVP (только для действия rsvp).

  • send_updatesstring

    Поведение уведомлений для create, update, delete и rsvp — "all" (по умолчанию), "externalOnly" или "none".

  • start_timestring

    Время начала (обязательно при создании). Смещение UTC в формате RFC3339 задаёт точный момент времени и сохраняется. Без смещения нужен start_timezone или timezone. Для локального времени по часам смещение опускается, а зона передаётся, чтобы Google учёл переход на летнее время; неверное смещение сдвигает событие. Значения только с датой создают события на весь день.

  • start_timezonestring

    IANA-часовой пояс только для начальной границы, переопределяет часовой пояс. Применяется для событий, у которых два конца находятся в разных зонах - рейс, вылетающий в 13:45 по "Asia/Jerusalem" и приземляющийся в 17:50 по "Europe/Amsterdam", - это одно событие, созданное в двух зонах. Явные смещения временных меток всегда сохраняют момент времени, даже если зона отличается.

  • summarystring

    Название события (обязательно при создании).

  • timezonestring

    IANA-часовой пояс, применяемый к обеим границам (например, "America/New_York"). Преобразует временные метки со смещением, не меняя их момент времени; интерпретирует временные метки без смещения как локальное время в этом часовом поясе. Переопределяется для каждой границы параметрами start_timezone/end_timezone.

  • transparencystring

    "непрозрачный" (занятый) или "прозрачный" (свободный).

  • use_default_remindersboolean

    Использовать ли напоминания по умолчанию.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

  • visibilitystring

    "default", "public", "private" или "confidential".

manage_focus_timeвнешний мир

Управляет событиями Focus Time в Google Calendar. Эти специальные события автоматически отклоняют приглашения на встречи и по умолчанию устанавливают статус чата пользователя в Do Not Disturb, помогая защищать блоки беспрерывного рабочего времени.

Управляет временем фокусировки

Параметры
  • actionstringобязательный

    Выполняемое действие — «создать», «перечислить», «обновить» или «удалить».

  • auto_decline_modestring

    Как обрабатывать конфликтующие приглашения. Одно из: "declineAllConflictingInvitations" (по умолчанию), "declineOnlyNewConflictingInvitations", "declineNone".

  • calendar_idstring

    Идентификатор календаря. По умолчанию используется значение 'primary'. События статуса Focus Time находятся в основных календарях, поэтому используйте 'primary' или идентификатор/email основного календаря пользователя, а не идентификатор вторичного календаря.

  • chat_statusstring

    Статус Google Chat во время фокусированного времени. Поддерживает "doNotDisturb" (по умолчанию) и "available".

  • decline_messagestring

    Сообщение, включаемое при автоматическом отклонении приглашений.

  • descriptionstring

    Описание события. Полезно для добавления контекста о том, для чего предназначено время фокусировки.

  • end_timestring

    Дата/время окончания (не включается в диапазон). Формат тот же, что и у start_time. Например, для одного полного дня 5 апреля укажите start_time='2026-04-05' и end_time='2026-04-06'. Обязательно для создания.

  • event_idstring

    Event ID. Требуется для действий «update» и «delete».

  • max_resultsinteger

    Для действия 'list': максимальное количество возвращаемых событий. По умолчанию — 10.

  • recurrencestring[]

    Правила повторения RFC5545 для повторяющейся серии Focus Time, например ["RRULE:FREQ=WEEKLY;COUNT=10"].

  • start_timestring

    Начальная дата/время. Используйте 'YYYY-MM-DD' для полного дня или RFC3339 для частичного дня (например, '2024-04-05T09:00:00Z'). Значения только с датой автоматически преобразуются в dateTime (от полуночи до полуночи). Обязательно для создания.

  • summarystring

    Отображает текст в календаре. По умолчанию — «Focus Time».

  • time_maxstring

    Для действия 'list': конец временного диапазона.

  • time_minstring

    Для действия «list»: начало временного диапазона. По умолчанию — текущее время. Повторяющиеся серии разворачиваются в отдельные экземпляры в запрошенном диапазоне.

  • timezonestring

    Часовой пояс для события (например, "America/New_York", "Europe/London"). Обязателен при использовании значений только с датой или значений даты и времени без явного смещения UTC.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_gmail_filterвнешний мир

Управляет фильтрами Gmail: создаёт, удаляет, обновляет и применяет к существующей почте. - update: у Gmail нет API для обновления фильтров, поэтому фильтр создаётся заново (сначала новый, затем удаляется старый), и его ID меняется. Переданный criteria или filter_action заменяет весь объект; если опустить одно из них, сохранится значение из старого фильтра. - apply: применяет действия по меткам фильтра к почте, УЖЕ находящейся в почтовом ящике (фильтры Gmail действуют только на новую почту). Изменяются только подходящие сообщения, а не целые беседы, как в веб-интерфейсе. Используйте filter_id или criteria + filter_action для разового запуска. Пересылка никогда не применяется. Сначала используйте dry_run=true, чтобы увидеть поисковый запрос и количество совпадений. Требуется область gmail.modify в дополнение к gmail.settings.basic.

Управляет фильтром Gmail

Параметры
  • actionstringобязательный

    "create", "delete", "update" или "apply".

  • criteriaobject

    Объект критериев фильтрации (обязателен для create; необязателен для update/apply).

  • dry_runboolean

    Только применить: подсчитывает совпадения, ничего не меняя.

  • filter_actionobject

    Объект действия фильтра (обязателен для create; необязателен для update/apply). Назван 'filter_action', чтобы не затенять параметр 'action'.

  • filter_idstring

    Идентификатор фильтра (обязателен для delete и update; необязателен для apply).

  • max_messagesinteger

    Применяет только: предохранительный лимит на изменённые сообщения (по умолчанию 5000).

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_gmail_labelвнешний мир

Управляет метками Gmail: создаёт, обновляет или удаляет метки.

Управление метками Gmail

Параметры
  • actionenumобязательный

    Действие, которое нужно выполнить над меткой.

  • background_colorstring

    Цвет фона метки в виде hex-строки, например "#fb4c2f". Задаётся вместе с text_color; Gmail требует оба значения. Gmail принимает только собственную палитру, и неподдерживаемое значение отклоняется до отправки запроса. Цвета применяются к пользовательским меткам, а не к системным.

  • clear_colorboolean

    При обновлении удаляет текущий цвет метки. Не комбинируется с background_color или text_color.

  • label_idstring

    Label ID. Требуется для операций обновления и удаления.

  • label_list_visibilityenum

    Отображается ли метка в списке меток. По умолчанию при создании - "labelShow". При обновлении, если опустить этот параметр, сохраняется текущая настройка метки.

  • message_list_visibilityenum

    Определяет, показываются ли сообщения метки в списке сообщений. При создании по умолчанию принимает значение "show". При обновлении, если его не указать, сохраняется текущая настройка метки.

  • namestring

    Название метки. Требуется при создании, необязательно при обновлении.

  • text_colorstring

    Цвет текста метки в виде hex-строки, например "#ffffff". Задаётся вместе с background_color. Та же палитра. При обновлении, если опустить оба параметра, цвет текста метки сохраняется.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_named_rangeвнешний мир

Управляет жизненным циклом именованных диапазонов в Google Таблице: перечисляет, создаёт, обновляет или удаляет.

Управление именованным диапазоном.

Параметры
  • actionstringобязательный

    Операция для выполнения: "list", "create", "update" или "delete". Обязательный параметр.

  • namestring

    Имя именованного диапазона (обязательно для "create"; необязательный идентификатор для "update"/"delete").

  • named_range_idstring

    ID именованного диапазона (необязательный идентификатор для "update"/"delete").

  • new_namestring

    Новое имя для именованного диапазона (используется с action="update").

  • new_rangestring

    Новый диапазон в формате A1 для именованного диапазона (используется с action="update").

  • range_namestring

    Целевая ячейка или диапазон в нотации A1 (например, "Sheet1!A1:D10", "A1:B5") (обязательно для "create").

  • spreadsheet_idstringобязательный

    Идентификатор электронной таблицы. Обязателен.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_out_of_officeвнешний мир

Управляет событиями Out of Office в Google Календаре. Эти специальные события автоматически отклоняют приглашения на встречи и устанавливают статус пользователя "Out of office" во всем Google Workspace.

Управление Out of Office

Параметры
  • actionstringобязательный

    Выполняемое действие — «создать», «перечислить», «обновить» или «удалить».

  • auto_decline_modestring

    Как обрабатывать конфликтующие приглашения. Одно из: "declineAllConflictingInvitations" (по умолчанию), "declineOnlyNewConflictingInvitations", "declineNone".

  • calendar_idstring

    Идентификатор календаря. По умолчанию — 'primary'. События статуса «Вне офиса» находятся в основных календарях, поэтому используйте 'primary' или основной идентификатор/адрес электронной почты календаря пользователя, а не вторичный идентификатор календаря.

  • decline_messagestring

    Сообщение, включаемое при автоматическом отклонении приглашений.

  • end_timestring

    Дата/время окончания (не включается в диапазон). Формат тот же, что и у start_time. Например, для одного полного дня 5 апреля укажите start_time='2026-04-05' и end_time='2026-04-06'. Обязательно для создания.

  • event_idstring

    Event ID. Требуется для действий «update» и «delete».

  • max_resultsinteger

    Для действия 'list': максимальное количество возвращаемых событий. По умолчанию — 10.

  • recurrencestring[]

    Правила повторения RFC5545 для повторяющейся серии Out of Office, например ["RRULE:FREQ=WEEKLY;COUNT=10"].

  • start_timestring

    Начальная дата/время. Используйте 'YYYY-MM-DD' для полного дня или RFC3339 для частичного дня (например, '2024-04-05T09:00:00Z'). Значения только с датой автоматически преобразуются в dateTime (от полуночи до полуночи). Обязательно для создания.

  • summarystring

    Текст для отображения в календаре. По умолчанию: "Out of Office".

  • time_maxstring

    Для действия 'list': конец временного диапазона.

  • time_minstring

    Для действия «list»: начало временного диапазона. По умолчанию — текущее время. Повторяющиеся серии разворачиваются в отдельные экземпляры в запрошенном диапазоне.

  • timezonestring

    Часовой пояс для события (например, "America/New_York", "Europe/London"). Обязателен при использовании значений только с датой или значений даты и времени без явного смещения UTC.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_presentation_commentвнешний мир

Управляет комментариями в Google Презентации. Действия: - create: Создаёт новый комментарий. Требует comment_content. Примечание: API Drive не может привязывать комментарии к произвольному тексту; через API комментарии в Презентациях прикрепляются к элементам. - reply: Отвечает на комментарий. Требует comment_id и comment_content. - resolve: Закрывает комментарий. Требует comment_id.

Управление комментарием презентации

Параметры
  • actionstringобязательный
  • comment_contentstring
  • comment_idstring
  • presentation_idstringобязательный
  • user_google_emailstringобязательный
manage_script_contentвнешний мир

Обновляет исходные файлы проекта Apps Script.

Управляет содержимым сценариев.

Параметры
  • actionstringобязательный

    обновить

  • filesobject[]

    Объекты File с полями name, type и source для создания или обновления (обязательно при обновлении).

  • mergeboolean

    Если True (по умолчанию), накладывает files на текущий проект. Если False, заменяет полный набор файлов проекта (только обновление).

  • script_idstringобязательный

    Идентификатор проекта скрипта.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя

manage_script_projectвнешний мир

Создаёт или удаляет проект Apps Script. Действия: - "create": Создаёт проект. Требует title; parent_id необязателен. - "delete": Окончательно удаляет проект. Требует script_id.

Управляет скриптовым проектом.

Параметры
  • actionstringобязательный
  • parent_idstring
  • script_idstring
  • titlestring
  • user_google_emailstringобязательный
manage_script_triggerвнешний мир

Перечисляет или удаляет устанавливаемые триггеры текущего пользователя в скриптовом проекте. У Apps Script REST API нет ресурса триггеров, поэтому в dev_mode оба действия создают (или обновляют) небольшой вспомогательный файл и запускают его через Execution API: единственный способ проверить или изменить состояние триггеров, не открывая редактор. Ни одно действие не ограничивается чтением: вспомогательный файл может быть записан в проект при первом использовании. Чтобы создать триггер, используйте generate_trigger_code для создания кода настройки, добавьте его с помощью manage_script_content, а затем запустите его через run_script_function.

Управляет триггером скрипта.

Параметры
  • actionstringобязательный

    Одно из значений: "list", "delete".

  • deployment_idstring

    Необязательный идентификатор развёртывания API Executable. Если его не указать, берётся развёртывание API Executable с самой высокой версией.

  • dev_modeboolean

    Запускает на последнем сохранённом коде (по умолчанию; только владелец проекта) в отличие от развёрнутой версии. False требует, чтобы helper уже существовал в развёрнутой версии.

  • handler_functionstring

    Удаляет все триггеры, вызывающие функцию с этим именем (только удаление).

  • script_idstringобязательный

    Идентификатор проекта скрипта.

  • trigger_idstring

    Уникальный ID конкретного триггера для удаления (только для удаления).

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя

manage_script_versionвнешний мир

Создаёт неизменяемые снимки версий проекта сценария. Версии сохраняют снимок текущего кода сценария; после создания их нельзя изменить.

Управление версией скрипта

Параметры
  • actionstringобязательный

    "создаёт".

  • descriptionstring

    Необязательное описание новой версии (только при создании).

  • script_idstringобязательный

    Идентификатор проекта скрипта.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя

manage_sheet_tabвнешний мир

Управляет жизненным циклом существующей вкладки листа: переименовать, удалить, скрыть, показать или изменить порядок. Используйте create_sheet, чтобы добавить вкладку, и resize_sheet_dimensions для изменений на уровне строк и столбцов. Этот инструмент работает с самой вкладкой.

Управление вкладкой листа

Параметры
  • actionstringобязательный

    Одно из "rename", "delete", "hide", "unhide", "reorder"

  • new_indexinteger

    Новая позиция с отсчётом от нуля, обязательна для action="reorder"

  • new_namestring

    Новое название, требуется для action="rename"

  • sheet_namestringобязательный

    Заголовок существующей вкладки, над которой нужно выполнить действие

  • spreadsheet_idstringобязательный

    ID электронной таблицы

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

manage_spreadsheet_commentвнешний мир

Управление комментариями в Google Таблице. Действия: - create: Создать новый комментарий. Требуется comment_content. Примечание: Drive API не может привязывать комментарии к произвольному тексту; комментарии в Таблицах привязаны к ячейкам через API. - reply: Ответить на комментарий. Требуются comment_id и comment_content. - resolve: Закрыть комментарий. Требуется comment_id.

Управление комментарием в электронной таблице

Параметры
  • actionstringобязательный
  • comment_contentstring
  • comment_idstring
  • spreadsheet_idstringобязательный
  • user_google_emailstringобязательный
manage_taskвнешний мир

Управляет задачами: создаёт, обновляет, удаляет или перемещает задачи в списках задач.

Управлять задачей

Параметры
  • actionstringобязательный

    Выполняемое действие. Должно быть одним из: "create", "update", "delete", "move".

  • destination_task_liststring

    ID целевого списка задач (для перемещения между списками). Используется действием «move».

  • duestring

    Срок выполнения в формате RFC 3339 (например, "2024-12-31T23:59:59Z"). Используется действиями "create" и "update".

  • notesstring

    Заметки/описание для задачи. Используется в действиях «создание» и «обновление».

  • parentstring

    ID родительской задачи (для подзадач). Используется действиями «create» и «move».

  • previousstring

    Идентификатор предыдущей задачи того же уровня (для позиционирования). Используется действиями "create" и "move".

  • statusstring

    Статус задачи ("needsAction" или "completed"). Используется действием "update".

  • task_idstring

    ID задачи. Требуется для действий «обновление», «удаление» и «перемещение».

  • task_list_idstringобязательный

    Идентификатор списка задач. Требуется для всех действий.

  • titlestring

    Название задачи. Обязательно для «create», необязательно для «update».

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

manage_task_listвнешний мир

Управляет списками задач: создаёт, обновляет, удаляет или очищает выполненные задачи.

Управление списком задач

Параметры
  • actionstringобязательный

    Действие, которое нужно выполнить. Должно быть одним из: "create", "update", "delete", "clear_completed".

  • task_list_idstring

    Идентификатор списка задач. Требуется для действий "update", "delete" и "clear_completed".

  • titlestring

    Заголовок для списка задач. Обязателен для действий «create» и «update».

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

modify_doc_textвнешний мир

Изменяет текст в Google Doc - может вставлять или заменять текст и/или применять форматирование одной операцией. СОВЕТ: Чтобы добавить текст в конец документа без вычисления индексов, установите end_of_segment=true. Это позволяет избежать ошибок при вычислении индексов. Для обычного текста верхнего/нижнего колонтитула используйте update_doc_headers_footers. Передавайте segment_id только если у вас уже есть реальный идентификатор сегмента верхнего/нижнего колонтитула или сноски из вывода inspect_doc_structure. Не угадывайте идентификаторы вроде "kix.header" или "kix.footer".

Изменяет текст документа

Параметры
  • background_colorstring

    Цвет фона/выделения (#RRGGBB)

  • baseline_offsetstring

    Одно из: NONE, SUPERSCRIPT, SUBSCRIPT

  • boldboolean

    Нужно ли делать текст жирным (True/False/None, чтобы оставить без изменений)

  • clear_linkboolean

    Удалить гиперссылку из целевого диапазона

  • document_idstringобязательный

    Идентификатор документа для обновления.

  • end_indexinteger

    Конечная позиция для замены/форматирования текста (если текст не указан, текст вставляется)

  • end_of_segmentboolean

    Вставьте текст в конец целевого сегмента вместо start_index.

  • font_familystring

    Название семейства шрифта (например, «Arial», «Times New Roman»)

  • font_sizenumber

    Размер шрифта в пунктах.

  • font_weightinteger

    Насыщенность шрифта (100–900 с шагом 100; требуется font_family)

  • italicboolean

    Следует ли делать текст курсивным (True/False/None, чтобы оставить без изменений)

  • link_urlstring

    Гиперссылка URL (http/https)

  • segment_idstring

    Необязательный идентификатор сегмента верхнего/нижнего колонтитула/сноски для нацеливания.

  • small_capsboolean

    Применять капитель

  • start_indexintegerобязательный

    Начальная позиция для операции с использованием индексов Docs API из inspect_doc_structure. Для основного тела документа также принимается 0 как псевдоним первой позиции для записи.

  • strikethroughboolean

    Следует ли зачеркивать текст (True/False/None, чтобы оставить без изменений).

  • tab_idstring

    Необязательный идентификатор вкладки документа для указания.

  • textstring

    Новый текст для вставки или замены (необязательно - можно форматировать существующий текст, не изменяя его).

  • text_colorstring

    Цвет текста переднего плана (#RRGGBB)

  • underlineboolean

    Подчеркивать ли текст (True/False/None, чтобы оставить без изменений)

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

modify_gmail_message_labelsвнешний мир

Добавляет или удаляет метки из письма Gmail. Чтобы заархивировать письмо, удалите метку INBOX. Чтобы удалить письмо, добавьте метку TRASH.

Изменить метки сообщений Gmail

Параметры
  • add_label_idsstring[]

    Список ID меток для добавления в сообщение.

  • message_idstringобязательный

    Идентификатор сообщения для изменения.

  • remove_label_idsstring[]

    Какие идентификаторы меток нужно удалить из сообщения.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

modify_sheet_valuesвнешний мир

Изменяет значения в указанном диапазоне Google Sheet: может записывать, обновлять или очищать значения, а также вставлять Smart Chips (файлы/папки Drive или People).

Изменить значения листа

Параметры
  • chipsstring | object | any[]

    Smart chip(s) для вставки вместо значений: - Одна строка URL или email для одной ячейки (например, "https://drive.google.com/drive/folders/123", "user@example.com"). - Список URL или email для одной ячейки (несколько чипов) или для нескольких ячеек (например, ["https://...", "https://..."]). - Двумерный список URL/email, соответствующий диапазону сетки. Для диапазона из одной строки или одного столбца каждый внутренний список в этом случае содержит чипы для одной ячейки (например, [["a@x.com", "b@x.com"]] помещает оба чипа в первую ячейку "A1:C1"). - Словарь или список словарей с явными свойствами (например, {"type": "drive", "uri": "..."}, {"type": "person", "email": "..."}). - JSON-строка, кодирующая любой из перечисленных выше форматов.

  • chip_typestring

    Задаёт тип чипа явно при передаче сырых строк в chips: "drive" (по умолчанию для URL/ID) или "person" (по умолчанию для email).

  • clear_valuesboolean

    Если True, очищает диапазон вместо записи значений. По умолчанию: False.

  • range_namestringобязательный

    Диапазон для изменения (например, "Sheet1!A1:D10", "A1:D10"). Обязательный параметр.

  • spreadsheet_idstringобязательный

    Идентификатор электронной таблицы. Обязателен.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

  • value_input_optionstring

    Как интерпретировать входные значения ("RAW" или "USER_ENTERED"). По умолчанию используется "USER_ENTERED".

  • valuesstring | string[][]

    Двумерный массив значений для записи/обновления. Может быть JSON-строкой или списком Python. Обязателен, кроме случаев, когда clear_values=True или указан chips.

move_sheet_rowsвнешний мир

Перемещает строки с одного листа на другой в пределах одной таблицы. Перемещение выполняется одной операцией batchUpdate (сначала copyPaste, затем deleteDimension). Важно: batchUpdate выполняет запросы последовательно, но не откатывает частичный сбой — если копирование прошло успешно, а удаление нет, строки могут дублироваться. Формулы, типы данных и форматирование сохраняются (в отличие от обхода через values.get/append). Номера строк начинаются с 1 (как в интерфейсе таблицы).

Переместить строки листа

Параметры
  • destination_sheetstringобязательный

    Название листа, куда перемещаются строки. Обязательно.

  • end_rowintegerобязательный

    Последняя строка для перемещения (счёт с 1, включительно). Обязательно.

  • source_sheetstringобязательный

    Название листа, из которого перемещаются строки. Обязательно.

  • spreadsheet_idstringобязательный

    Идентификатор электронной таблицы. Обязателен.

  • start_rowintegerобязательный

    Первая строка для перемещения (с отсчётом от 1, включительно). Обязательно.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

query_freebusyтолько чтениеидемпотентныйвнешний мир

Возвращает информацию о свободном/занятом времени для набора календарей.

Запрашивает информацию Freebusy.

Параметры
  • calendar_expansion_maxinteger

    Максимальное количество календарей, для которых должна быть предоставлена информация о занятости. Необязательно. Максимальное значение: 50.

  • calendar_idsstring[]

    Список идентификаторов календарей для запроса. Если не указан, запрашивается основной календарь. Используйте primary для основного календаря пользователя или конкретные идентификаторы календарей, полученные из list_calendars.

  • group_expansion_maxinteger

    Максимальное количество идентификаторов календарей для одной группы. Необязательно. Если в группе больше участников, чем это значение, возвращается ошибка. Максимальное значение: 100.

  • time_maxstringобязательный

    Конец интервала для запроса в формате RFC3339 (например, '2024-05-12T18:00:00Z' или '2024-05-12').

  • time_minstringобязательный

    Начало интервала для запроса в формате RFC3339 (например, '2024-05-12T10:00:00Z' или '2024-05-12').

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

read_sheet_valuesтолько чтениеидемпотентныйвнешний мир

Читает значения из заданного диапазона в Google Таблице.

Read Sheet Values

Параметры
  • include_formulasboolean

    Если значение равно True, также извлекаются необработанные строки формул для ячеек, содержащих формулы. Это полезно для выявления межлистовых ссылок перед записью обратно в диапазон. По умолчанию используется значение False, чтобы избежать дополнительного API-запроса.

  • include_hyperlinksboolean

    Если задано True, также извлекает метаданные гиперссылок для диапазона. По умолчанию используется False, чтобы избежать дорогостоящих запросов includeGridData.

  • include_notesboolean

    Если значение True, также извлекает примечания к ячейкам для диапазона. По умолчанию используется False, чтобы избежать дорогостоящих запросов includeGridData.

  • include_smart_chipsboolean

    Если True, дополнительно получает метаданные smart chips (файлы и папки Drive, а также чипы People) для диапазона. По умолчанию False, чтобы избежать дорогостоящих запросов includeGridData.

  • range_namestring

    Диапазон для чтения (например, "Sheet1!A1:D10", "A1:D10"). По умолчанию используется "A1:Z1000". Открытые или слишком большие диапазоны ограничиваются максимум 1000 строками перед запросом к Sheets API, чтобы ограничить использование памяти.

  • spreadsheet_idstringобязательный

    Идентификатор электронной таблицы. Обязателен.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

resize_sheet_dimensionsвнешний мир

Управляет свойствами размеров на уровне листа: изменение размера столбцов/строк, автоматическое изменение размера по содержимому, закрепление строк/столбцов, скрытие/отображение строк/столбцов и вставка/удаление строк/столбцов.

Изменить размеры листа

Параметры
  • auto_resize_columnsstring | string[]

    Список букв столбцов для автоматического изменения размера под содержимое. Пример: ["A", "B"].

  • auto_resize_rowsstring | integer[]

    Список номеров строк (начиная с 1) для автоматического изменения размера под содержимое. Пример: [1, 2].

  • column_sizesstring | object

    Словарь, сопоставляющий буквы столбцов с шириной в пикселях. Пример: {"A": 200, "C": 300}. Может быть JSON-строкой или Python-словарем.

  • delete_columnsstring | string[]

    Перечислите буквы столбцов, которые нужно удалить. Пример: ["E", "F"].

  • delete_row_rangestring

    Непрерывный диапазон строк для удаления, в формате "start:end" (с 1 по N включительно). Например, "5:10" удаляет строки с 5 по 10. Эффективнее, чем delete_rows, для больших непрерывных диапазонов.

  • delete_rowsstring | integer[]

    Список номеров строк с отсчётом от 1 для удаления. Пример: [5, 6]. Лучше всего подходит для несмежных строк.

  • frozen_column_countinteger

    Сколько столбцов закрепить слева. Укажите 0, чтобы снять закрепление со всех столбцов.

  • frozen_row_countinteger

    Количество строк для закрепления сверху. Используйте 0, чтобы открепить все строки.

  • hide_columnsstring | string[]

    Список букв столбцов для скрытия. Пример: ["C", "D"].

  • hide_rowsstring | integer[]

    Список номеров строк для скрытия, нумерация начинается с 1. Пример: [3, 4].

  • insert_columnsinteger

    Количество столбцов для вставки.

  • insert_columns_atstring

    Буква столбца для вставки перед (например, "C"). Если не указано, добавляется в конец.

  • insert_rowsinteger

    Количество строк для вставки.

  • insert_rows_atinteger

    Номер строки (отсчет от 1) для вставки перед ней. Если не указано, добавляет в конец листа.

  • row_sizesstring | object

    Словарь, сопоставляющий номера строк (начиная с 1) с высотами в пикселях. Пример: {"1": 40, "3": 60}. Может быть JSON-строкой или словарём Python.

  • sheet_namestring

    Имя целевого листа. Если не указано, по умолчанию используется первый лист.

  • spreadsheet_idstringобязательный

    Идентификатор электронной таблицы. Обязателен.

  • unhide_columnsstring | string[]

    Список букв столбцов для отображения. Пример: ["C", "D"].

  • unhide_rowsstring | integer[]

    Список номеров строк с отсчетом от 1 для отображения. Пример: [3, 4].

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

run_script_functionвнешний мир

Выполняет функцию в развернутом скрипте.

Выполняет функцию скрипта.

Параметры
  • deployment_idstring

    Необязательный идентификатор развертывания API Executable. Когда он указан, пропускает автоматический поиск развертывания. Когда не указан, используется версионированное развертывание API Executable с наибольшим номером версии.

  • dev_modeboolean

    Запускать ли последний код или развернутую версию

  • function_namestringобязательный

    Имя функции для выполнения

  • parametersany[]

    Необязательный список параметров для передачи.

  • script_idstringобязательный

    Идентификатор проекта скрипта.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя

search_contactsтолько чтениеидемпотентныйвнешний мир

Ищет контакты по имени, email, номеру телефона или другим полям.

Поиск контактов

Параметры
  • page_sizeinteger

    Максимальное количество возвращаемых результатов (по умолчанию: 30, максимум: 30).

  • querystringобязательный

    Строка поискового запроса (ищет по именам, адресам электронной почты, номерам телефонов).

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

search_customтолько чтениеидемпотентныйвнешний мир

Выполняет поиск с помощью Google Custom Search JSON API.

Search Custom

Параметры
  • countrystring

    Код страны для результатов (например, "countryUS").

  • date_restrictstring

    Ограничьте результаты по дате (например, "d5" — за последние 5 дней, "m3" — за последние 3 месяца).

  • file_typestring

    Фильтровать по типу файла (например, "pdf", "doc").

  • languagestring

    Код языка для результатов (например, «lang_en»).

  • numinteger

    Количество возвращаемых результатов (1-10). По умолчанию 10.

  • qstringобязательный

    Поисковый запрос. Обязательно.

  • safeenum

    Уровень безопасного поиска. По умолчанию — "off".

  • search_typeenum

    Ищет изображения, если установлено значение "image".

  • sitesstring[]

    Список сайтов/доменов для ограничения поиска (например, ["example.com", "docs.example.com"]). Если указано, результаты ограничиваются этими сайтами.

  • site_searchstring

    Ограничьте поиск конкретным сайтом/доменом.

  • site_search_filterenum

    Исключить ("e") или включить ("i") результаты site_search.

  • startinteger

    Индекс первого возвращаемого результата (начиная с 1). По умолчанию — 1.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

search_docsтолько чтениеидемпотентныйвнешний мир

Ищет документы Google по имени с помощью Drive API (фильтр mimeType).

Search Docs

Параметры
  • corporastring

    Корпус для поиска ('user', 'domain', 'drive', 'allDrives'). По умолчанию принимает значение 'drive', если задан drive_id, иначе 'allDrives'.

  • drive_idstring

    Необязательный ID общего диска для поиска.

  • page_sizeinteger

    Максимальное количество документов для возврата. По умолчанию 100.

  • page_tokenstring

    Токен страницы из nextPageToken предыдущего ответа для получения следующей страницы результатов.

  • querystringобязательный

    Текст для поиска в именах документов.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя.

search_drive_filesтолько чтениеидемпотентныйвнешний мир

Ищет файлы и папки в Google Диске пользователя, включая общие диски.

Ищет файлы Drive

Параметры
  • corporastring

    Наборы элементов для запроса (например, 'user', 'domain', 'drive', 'allDrives'). Если указан 'drive_id' и 'corpora' имеет значение None, по умолчанию используется 'drive'. В противном случае по умолчанию используется 'allDrives', когда include_items_from_all_drives имеет значение True. Передайте 'user', чтобы искать только в My Drive и файлах, которыми поделились с пользователем.

  • detailedboolean

    Определяет, включать ли размер, время изменения и ссылку в результаты. По умолчанию — True.

  • drive_idstring

    Идентификатор общего диска для поиска. Если указано None, поведение зависит от corpora и include_items_from_all_drives.

  • file_typestring

    Ограничивает результаты по конкретному типу файла. Принимает понятное название ('folder', 'document'/'doc', 'spreadsheet'/'sheet', 'presentation'/'slides', 'form', 'drawing', 'pdf', 'shortcut', 'script', 'site', 'jam'/'jamboard') или любую строку с сырым MIME-типом (например, 'application/pdf'). По умолчанию — None (все типы).

  • include_items_from_all_drivesboolean

    Следует ли включать элементы общих дисков в результаты. По умолчанию — True. Это действует, когда не указан drive_id.

  • include_trashedboolean

    Включает ли файлы в корзину. По умолчанию — False, что соответствует веб-интерфейсу Drive и list_drive_items. Игнорируется, когда query уже содержит собственное условие trashed (= или !=), которое всегда имеет приоритет.

  • order_bystring

    Порядок сортировки. Список ключей сортировки через запятую с необязательным модификатором 'desc'. Допустимые ключи: 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'. Пример: 'modifiedTime desc' или 'folder,modifiedTime desc,name'. По умолчанию — None (стандартный порядок сортировки Drive API).

  • page_sizeinteger

    Максимальное количество файлов для возврата. По умолчанию — 10.

  • page_tokenstring

    Токен страницы из nextPageToken предыдущего ответа для получения следующей страницы результатов.

  • querystringобязательный

    Строка поискового запроса. Поддерживает операторы поиска Google Drive. ПРИМЕЧАНИЕ: Запросы на основе владельца ('user@example.com' в owners) НЕ РАБОТАЮТ в общих дисках, потому что файлы принадлежат самому общему диску, а не отдельным пользователям. Для поиска недавних файлов конкретного пользователя в общих дисках ищите по modifiedTime и используйте order_by='modifiedTime desc'.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

search_gmail_messagesтолько чтениеидемпотентныйвнешний мир

Ищет сообщения в учётной записи Gmail пользователя по запросу. Возвращает как идентификаторы сообщений (Message IDs), так и идентификаторы цепочек (Thread IDs) для каждого найденного сообщения, вместе со ссылками на веб-интерфейс Gmail для ручной проверки. Поддерживает постраничную навигацию с помощью параметра page_token.

Ищет сообщения Gmail

Параметры
  • include_headersboolean

    Если True, дополнительно подтягивает метаданные каждого сообщения и включает Subject, From и Date в каждый результат. Стоит одно получение метаданных на результат, сгруппированных в HTTP-пакеты до 10, плюс повторные попытки при временных сбоях. По умолчанию False (вывод не меняется по сравнению с предыдущими версиями).

  • page_sizeinteger

    Максимальное количество возвращаемых сообщений. По умолчанию — 10.

  • page_tokenstring

    Токен для получения следующей страницы результатов. Используйте next_page_token из предыдущего ответа.

  • querystringобязательный

    Поисковый запрос. Поддерживает стандартные операторы поиска Gmail.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

search_messagesтолько чтениеидемпотентныйвнешний мир

Ищет сообщения в пространствах Google Chat по текстовому содержимому и/или временному диапазону.

Поиск сообщений

Параметры
  • max_spacesinteger

    Максимальное количество пространств для поиска, когда space_id не указан (по умолчанию 10).

  • page_sizeinteger

    Максимальное количество сообщений, возвращаемых на пространство.

  • querystring

    Необязательный текст для поиска. Если параметр опущен, применяется только time_filter.

  • space_idstring

    Необязательное поле для ограничения поиска.

  • time_filterstring

    Необязательный фильтр с использованием синтаксиса createTime в Chat API. Примеры: 'createTime > "2026-03-18T00:00:00-03:00"' 'createTime > "2026-03-18T00:00:00-03:00" AND createTime < "2026-03-19T00:00:00-03:00"'

  • user_google_emailstringобязательный
send_gmail_messageвнешний мир

Отправляет электронное письмо через аккаунт Gmail пользователя. Поддерживает новые письма, ответы и пересылки, с необязательными вложениями. Поддерживает функцию Gmail "Send As" для отправки с настроенных адресов-алиасов. Чтобы переслать существующее сообщение, передайте forward_message_id. Исходная тема, тело (процитированное с заголовком "Forwarded message") и вложения переносятся. В режиме пересылки тело (если есть) добавляется в начало как примечание, а тема необязательна. Параметры ветки обсуждения, ответа и подписи не применяются при пересылке. ЭТОТ ИНСТРУМЕНТ ОТПРАВЛЯЕТ НЕМЕДЛЕННО И НЕ МОЖЕТ ПЛАНИРОВАТЬ. REST API Gmail не предоставляет параметр времени отправки; отложенная отправка - это функция веб-интерфейса без эквивалента в API, поэтому ни один аргумент этого инструмента не может отложить доставку. Никогда не говорите пользователю, что сообщение было запланировано. Для сценария «подготовить сейчас, доставить позже» создайте черновик с помощью draft_gmail_message. Внешний планировщик должен хранить данные сообщения, чтобы создать и отправить новое сообщение через send_gmail_message в выбранное время, или вызвать users.drafts.send с идентификатором черновика, возвращённым draft_gmail_message. Альтернативно, позвольте пользователю запланировать этот черновик в интерфейсе Gmail.

Отправить сообщение Gmail

Параметры
  • attachmentsobject[]

    Необязательный список вложений. Каждый элемент может содержать: "url" (загрузить по URL — работает с URL вложений MCP из get_drive_file_download_url / get_gmail_attachment_content), ИЛИ "path" (путь к файлу, автоматически кодируется), ИЛИ "content" (стандартный base64, не urlsafe) + "filename". Необязательный "mime_type". Необязательный "content_id" (строка) делает вложение встроенным: оно попадает в часть multipart/related с Content-ID: <content_id> и Content-Disposition: inline, и HTML-тело может ссылаться на него через <img src="cid:<content_id>"> (RFC 2392). Без content_id вложение является обычным вложением multipart/mixed. Пример: [{"url": "https://host/attachments/abc-123", "filename": "report.pdf"}]

  • bccstring

    Необязательный адрес электронной почты для скрытой копии.

  • bodystring

    Содержимое тела письма (обычный текст или HTML). Обязательно при отправке. При пересылке это необязательная заметка, добавляемая над цитируемым оригиналом.

  • body_formatenum

    Формат содержимого тела (и добавленной заметки при пересылке). Используйте 'plain' для обычного текста или 'html' для HTML-содержимого.

  • ccstring

    Необязательный адрес электронной почты для копии.

  • forward_message_idstring

    Установите идентификатор сообщения Gmail, чтобы переслать это сообщение вместо создания нового. Исходные тема, тело и (при необходимости) вложения переносятся; 'body' становится необязательной заметкой, добавляемой в начало пересылаемого сообщения.

  • from_emailstring

    Опциональный адрес электронной почты для псевдонима "Send As". Должен быть настроен в настройках Gmail (Настройки > Аккаунты > Отправлять письма как). Если не указан, используется email аутентифицированного пользователя.

  • from_namestring

    Необязательное отображаемое имя отправителя (например, 'Peter Hartree'). Если оно указано, заголовок From будет отформатирован как 'Name <email>'.

  • include_forwarded_attachmentsboolean

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

  • include_signatureboolean

    Определяет, следует ли добавлять подпись Gmail из раздела «Настройки» > «Подпись», если она доступна. По умолчанию — true.

  • in_reply_tostring

    Необязательный RFC Message-ID для явного ответа на конкретное сообщение (например, 'message123@gmail.com'). Опустите, чтобы ответить на последнее подходящее сообщение в thread_id.

  • quote_originalboolean

    Определяет, нужно ли включать исходное сообщение, на которое даётся ответ, в качестве цитаты. Параметр действует только при указанном thread_id. По умолчанию — false.

  • referencesstring

    Необязательная цепочка предков Message-ID. Обычно опускается, когда указан thread_id; сервер выводит цепочку через выбранную цель ответа.

  • reply_allboolean

    Определяет, нужно ли выводить получателей для ответа всем из ветки обсуждения: To = отправитель, на которого отвечают, Cc = остальные участники, исключая аутентифицированную учетную запись и from_email. Требуется thread_id. Явные значения to/cc имеют приоритет; когда cc опущено, отправитель, на которого отвечают, добавляется в выведенный Cc, если его еще нет в To. По умолчанию: false.

  • subjectstring

    Тема письма. Обязательна при отправке; необязательна при пересылке (по умолчанию — 'Fwd: <исходная тема>').

  • thread_idstring

    Необязательный ID ветки Gmail, в которой нужно ответить. Когда параметр in_reply_to опущен, ответ отправляется на последнее сообщение, не являющееся черновиком и не находящееся в корзине, с RFC-идентификатором сообщения.

  • tostring

    Адрес электронной почты получателя. Необязателен при ответе с reply_all=True, который берёт его из ветки обсуждения.

  • user_google_emailstringобязательный

    Адрес Gmail пользователя. Требуется для аутентификации.

send_messageвнешний мир

Отправляет сообщение в пространство Google Chat или редактирует уже отправленное туда сообщение.

Отправить сообщение

Параметры
  • message_namestring

    Редактирует это сообщение на месте, а не отправляет новое (например, spaces/X/messages/Y, как возвращают send_message или get_messages). Сообщение должно принадлежать пространству space_id. Заменяется только текст, и только автор может редактировать своё сообщение.

  • message_textstringобязательный
  • space_idstringобязательный
  • thread_keystring

    Отвечает в ветке по ключу, заданному приложением (создаёт ветку, если она не найдена).

  • thread_namestring

    Отвечает в существующем треде по имени ресурса (например, spaces/X/threads/Y).

  • user_google_emailstringобязательный
set_drive_file_permissionsвнешний мир

Устанавливает настройки общего доступа на уровне файла и управляет ссылками для общего доступа к файлу или папке Google Drive. Это высокоуровневый инструмент для самых частых изменений разрешений. Используйте его, чтобы включить или отключить доступ "для всех у кого есть ссылка" или настроить поведение общего доступа на уровне файла. Для управления разрешениями отдельных пользователей или групп используйте share_drive_file или update_drive_permission.

Установить разрешения для файлов Drive

Параметры
  • copy_requires_writer_permissionboolean

    Определяет, запрещено ли зрителям и комментаторам копирование, печать или скачивание. По умолчанию — нет (без изменений).

  • file_idstringобязательный

    Идентификатор файла или папки. Обязательно.

  • link_sharingstring

    Управление доступом к файлу для "всех, у кого есть ссылка". - "off": Отключить доступ "для всех, у кого есть ссылка" к этому файлу. - "reader": Все, у кого есть ссылка, могут просматривать. - "commenter": Все, у кого есть ссылка, могут оставлять комментарии. - "writer": Все, у кого есть ссылка, могут редактировать.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

  • writers_can_shareboolean

    Редакторы могут изменять разрешения и предоставлять доступ. Если значение False, только владелец может предоставлять доступ. По умолчанию — None (без изменений).

set_publish_settingsвнешний мир

Обновляет настройки публикации формы.

Set Publish Settings

Параметры
  • form_idstringобязательный

    Идентификатор формы, для которой нужно обновить настройки публикации.

  • is_accepting_responsesboolean

    Определяет, принимает ли форма ответы. Действует только когда форма опубликована. По умолчанию — True.

  • is_publishedboolean

    Определяет, опубликована ли форма и видна ли она респондентам. По умолчанию - True.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

start_google_authвнешний мир

Запускает вручную процесс аутентификации Google OAuth. ПРИМЕЧАНИЕ: Это устаревший инструмент OAuth 2.0, отключенный при включенном OAuth 2.1. Система аутентификации автоматически обрабатывает проверку учетных данных и запрашивает аутентификацию при необходимости. Используйте этот инструмент только если: 1. Требуется повторная аутентификация с другими учетными данными 2. Вы хотите выполнить аутентификацию заранее перед использованием других инструментов 3. Автоматический поток аутентификации завершился ошибкой и требуется повторная попытка В большинстве случаев достаточно просто вызвать нужный инструмент Google Workspace. Он автоматически обработает аутентификацию, если потребуется.

Запускает Google Auth.

Параметры
  • service_namestringобязательный
  • user_google_emailstring
update_doc_headers_footersвнешний мир

Безопасно создаёт или обновляет текст верхнего/нижнего колонтитула в Google Doc. Это инструмент по умолчанию для содержимого колонтитулов. НЕ используйте batch_update_doc с create_header_footer только для установки текста колонтитула; эта низкоуровневая операция предназначена исключительно для продвинутых сценариев с разрывами разделов и может завершиться ошибкой, если колонтитул по умолчанию уже существует. Этот инструмент выполняет и создание, и обновление за один вызов: - Если колонтитула нет, он сначала автоматически создаётся. - Если колонтитул уже существует, его содержимое заменяется. Вам НЕ нужно создавать колонтитул отдельно перед вызовом этого инструмента. Просто вызовите его с нужным содержимым — он сработает независимо от того, существует колонтитул или нет.

Обновляет заголовки и нижние колонтитулы документа

Параметры
  • contentstringобязательный

    Текстовое содержимое для шапки/подвала

  • document_idstringобязательный

    Идентификатор документа для обновления.

  • header_footer_typestring

    Тип верхнего/нижнего колонтитула («DEFAULT», «FIRST_PAGE_ONLY», «EVEN_PAGE»)

  • section_typestringобязательный

    Тип раздела для создания или обновления («header» или «footer»)

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

update_drive_fileвнешний мир

Обновляет метаданные, свойства и/или содержимое файла Google Drive. Новое содержимое (встроенное как content, полученное из file_url или прочитанное из файла по пути на локальном сервере) заменяет содержимое файла на месте, сохраняя существующий идентификатор файла, доступ, комментарии и ссылки. Для нативных Google Docs/Sheets/Slides исходный файл загружается с его исходным MIME-типом, поэтому Drive API применяет то же преобразование формата, что и import_to_google_doc (заголовки Markdown, таблицы, жирный шрифт и т. д.). Для любого другого файла (.md, .txt, .pdf, ...) преобразовывать нечего, поэтому байты записываются как есть под собственным MIME-типом файла. Метаданные и содержимое можно обновить одним вызовом. mode='append'/'prepend' вставляют content в существующий текст файла на стороне сервера, поэтому достаточно передать только новый текст, не нужно отправлять весь файл для перезаписи. Ярлыки Drive обрабатываются в зависимости от типа обновления: поддерживаемые изменения локальных для ресурса метаданных (переименование, перемещение, корзина, звезда, описание и настраиваемые свойства) применяются к переданному ярлыку, а замена содержимого переходит по ярлыку и обновляет его целевой объект. Чтобы не применить метаданные не к тому ресурсу, вызов с ярлыком не может сочетать содержимое с локальными для ресурса метаданными. Обновляйте метаданные ярлыка и содержимое целевого объекта отдельными вызовами.

Обновляет Drive File

Параметры
  • add_parentsstring

    Идентификаторы папок через запятую для добавления в качестве родительских.

  • contentstring

    Новое текстовое содержимое для текстовых форматов (markdown, TXT, HTML).

  • copy_requires_writer_permissionboolean

    Указывает, требуется ли для копирования разрешение на запись. Передавайте целевой ID напрямую; это значение нельзя изменить для ресурса-ярлыка.

  • descriptionstring

    Новое описание для файла.

  • file_idstringобязательный

    ID файла для обновления. Обязательно.

  • file_pathstring

    Локальный путь к файлу для бинарных форматов (DOCX, ODT). Поддерживает URL вида file://.

  • file_urlstring

    Удаленный URL-адрес http(s) для получения нового контента.

  • mime_typestring

    Новый тип MIME (примечание: изменение типа может потребовать загрузки контента). Для идентификатора ярлыка это должно сопровождать контент и применяться к разрешенной цели.

  • modestring

    Как применить новый контент - 'replace' (по умолчанию), 'append' или 'prepend'. Append/prepend требуют 'content' и текстовый файл в кодировке UTF-8, такой как .md или .txt; перевод строки вставляется в месте соединения, если ни одна из сторон не имеет его. Для нативных Google Docs используйте insert_doc_elements, modify_doc_text или find_and_replace_doc, которые редактируют на месте вместо перезаписи файла.

  • namestring

    Новое имя для файла.

  • propertiesobject

    Пользовательские свойства «ключ-значение» для файла.

  • remove_parentsstring

    Идентификаторы папок, разделенные запятыми, для удаления из родительских папок.

  • source_formatstring

    Подсказка по формату источника для преобразования (md, markdown, docx, txt, html, rtf, odt). Определяется автоматически, если не указан, и игнорируется для файлов не из Google, которые загружаются без преобразования. Укажите не более одного источника контента.

  • starredboolean

    Стоит ли ставить или убирать звезду у файла?

  • trashedboolean

    Нужно ли перемещать файл в корзину или из корзины.

  • user_google_emailstringобязательный

    Адрес электронной почты Google пользователя. Обязательно.

  • writers_can_shareboolean

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

update_paragraph_styleвнешний мир

Применяет форматирование на уровне абзаца, стили заголовков и/или форматирование списков к диапазону в Google Doc. Этот инструмент применяет именованные стили заголовков (H1-H6) для семантической структуры документа, создаёт маркированные или нумерованные списки с вложенными отступами и настраивает свойства абзаца, такие как выравнивание, интервалы и отступы. Все операции выполняются за один вызов.

Обновляет стиль абзаца

Параметры
  • alignmentstring

    Выравнивание текста - 'START' (слева), 'CENTER', 'END' (справа) или 'JUSTIFIED'

  • avoid_widow_and_orphanboolean

    Избегайте висячих строк в абзаце

  • border_colorstring

    Цвет границы (#RRGGBB; по умолчанию: черный)

  • border_dashstring

    Стиль линии границы ('SOLID', 'DOT' или 'DASH'; по умолчанию — 'SOLID')

  • border_edgesenum[]

    Границы абзаца, которые нужно обновить ('верхняя', 'нижняя', 'левая', 'правая' или 'между'); если не указано, обновляются все четыре внешние границы

  • border_paddingnumber

    Внутренний отступ границы в пунктах (по умолчанию 4)

  • border_widthnumber

    Ширина границы в пунктах (по умолчанию — 1).

  • bullet_presetstring

    Необязательный явный пресет маркеров Google Docs.

  • directionstring

    Направление абзаца: 'LEFT_TO_RIGHT' или 'RIGHT_TO_LEFT'

  • document_idstringобязательный

    ID документа для изменения

  • end_indexintegerобязательный

    Конечная позиция (исключая) — должна охватывать весь абзац

  • heading_levelinteger

    Уровень заголовка 0-6 (0 = NORMAL_TEXT, 1 = H1, 2 = H2 и т. д.) Используйте для семантической структуры документа.

  • indent_endnumber

    Отступ справа/в конце в пунктах

  • indent_first_linenumber

    Отступ первой строки в пунктах (например, 36 для 0,5 дюйма)

  • indent_startnumber

    Отступ слева/в начале в пунктах

  • keep_lines_togetherboolean

    Сохраняйте все строки абзаца вместе.

  • keep_with_nextboolean

    Понял, добавляю правило: сохраняю структуру абзацев — не объединяю и не разбиваю их, переношу разбивку на абзацы из исходного текста в перевод без изменений.

  • line_spacingnumber

    Множитель межстрочного интервала (1.0 = одинарный, 1.5 = полуторный, 2.0 = двойной)

  • list_nesting_levelinteger

    Уровень вложенности для списков (от 0 до 8, где 0 — верхний уровень, по умолчанию — 0). Используйте более высокие значения для вложенных или с отступом элементов списка.

  • list_typestring

    Создаёт список из существующих абзацев ('UNORDERED' для маркеров, 'ORDERED' для номеров, 'CHECKBOX' для чек-листов) или 'NONE' для удаления форматирования списка из диапазона. Значение 'NONE' используется, когда текст, вставленный после списка, унаследовал его маркеры: установка named_style_type или heading_level не очищает принадлежность к списку, только 'NONE' делает это.

  • named_style_typestring

    Прямой именованный тип стиля — 'NORMAL_TEXT', 'TITLE', 'SUBTITLE', 'HEADING_1' – 'HEADING_6'. Взаимоисключающий с heading_level.

  • page_break_beforeboolean

    Начните абзац на новой странице.

  • segment_idstring

    Необязательный идентификатор сегмента верхнего/нижнего колонтитула/сноски для нацеливания.

  • shading_colorstring

    Заливка абзаца / цвет фона (#RRGGBB)

  • space_abovenumber

    Интервал перед абзацем в пунктах (например, 12 для одной строки)

  • space_belownumber

    Интервал после абзаца в пунктах

  • spacing_modestring

    'NEVER_COLLAPSE' или 'COLLAPSE_LISTS'

  • start_indexintegerобязательный

    Начальная позиция с использованием индексов Docs API из inspect_doc_structure. Для основного текста 0 также принимается как псевдоним первой позиции для записи.

  • tab_idstring

    Необязательный идентификатор вкладки документа для указания.

  • user_google_emailstringобязательный

    Адрес электронной почты пользователя Google

2.1.1основная
2.1.0
2.0.1
2.0.0
1.30.1
1.30.0
1.29.0
1.28.0
1.27.1
1.27.0
1.26.2
1.26.1
1.26.0
1.25.2
1.25.1
1.25.0
1.24.1
1.24.0
1.23.1
1.23.0
1.22.2
1.22.1
1.22.0
1.21.3
1.21.2
1.21.1
1.21.0
1.20.4
1.20.3
1.20.1
1.20.0
1.19.0
1.18.0
1.17.3
1.17.2
1.17.1
1.17.0
1.16.2
1.16.1
1.16.0
1.15.3
1.15.1
1.15.0
1.14.3
1.14.2
1.14.1
1.14.0
1.13.1
1.13.0
1.12.0
1.11.5
1.11.4
1.11.2
1.11.1
1.11.0
1.10.7
1.10.6
1.10.5
1.10.4
1.10.3
1.10.1
1.10.0
1.9.0
1.8.3
1.8.2
1.8.1
1.8.0
1.7.1
1.7.0
1.6.3
1.6.2
1.6.1
1.6.0
1.5.5
1.5.4
1.5.3
1.5.2
1.5.1
1.5.0
1.4.8
1.4.7
1.4.6
1.4.5
1.4.4
1.4.3
1.4.2
1.4.1
1.4.0
1.3.4
1.3.3
1.3.2
1.3.1
1.3.0
1.2.2
1.2.1
1.2.0
1.1.17
1.1.16
1.1.15
1.1.14
1.1.13
1.1.12
1.1.10
1.1.9
1.1.8
1.1.7
1.1.6
1.1.5
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.6
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0
0.2.0

Выберите клиент, чтобы установить taylorwilsdon/google_workspace_mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "taylorwilsdon-googleworkspacemcp-mvdpgtttyn": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-secret",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "taylorwilsdon-googleworkspacemcp-mvdpgtttyn": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-secret",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "taylorwilsdon-googleworkspacemcp-mvdpgtttyn": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-secret",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"taylorwilsdon-googleworkspacemcp-mvdpgtttyn\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"workspace-mcp\"],\"env\":{\"GOOGLE_OAUTH_CLIENT_ID\":\"your-client-id\",\"GOOGLE_OAUTH_CLIENT_SECRET\":\"your-secret\",\"OAUTHLIB_INSECURE_TRANSPORT\":\"1\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "taylorwilsdon-googleworkspacemcp-mvdpgtttyn": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-secret",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add taylorwilsdon-googleworkspacemcp-mvdpgtttyn --env GOOGLE_OAUTH_CLIENT_ID=your-client-id --env GOOGLE_OAUTH_CLIENT_SECRET=your-secret --env OAUTHLIB_INSECURE_TRANSPORT=1 -- uvx workspace-mcp

Либо через JSON-конфиг:

claude mcp add-json taylorwilsdon-googleworkspacemcp-mvdpgtttyn "{\"command\":\"uvx\",\"args\":[\"workspace-mcp\"],\"env\":{\"GOOGLE_OAUTH_CLIENT_ID\":\"your-client-id\",\"GOOGLE_OAUTH_CLIENT_SECRET\":\"your-secret\",\"OAUTHLIB_INSECURE_TRANSPORT\":\"1\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add taylorwilsdon-googleworkspacemcp-mvdpgtttyn --env GOOGLE_OAUTH_CLIENT_ID=your-client-id --env GOOGLE_OAUTH_CLIENT_SECRET=your-secret --env OAUTHLIB_INSECURE_TRANSPORT=1 -- uvx workspace-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.taylorwilsdon-googleworkspacemcp-mvdpgtttyn]
command = "uvx"
args = ["workspace-mcp"]

[mcp_servers.taylorwilsdon-googleworkspacemcp-mvdpgtttyn.env]
GOOGLE_OAUTH_CLIENT_ID = "your-client-id"
GOOGLE_OAUTH_CLIENT_SECRET = "your-secret"
OAUTHLIB_INSECURE_TRANSPORT = "1"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите taylorwilsdon/google_workspace_mcp, а в поле команды запуска — строку ниже:
uvx workspace-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "taylorwilsdon-googleworkspacemcp-mvdpgtttyn": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-secret",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "taylorwilsdon-googleworkspacemcp-mvdpgtttyn": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-secret",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например taylorwilsdon-googleworkspacemcp-mvdpgtttyn.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: taylorwilsdon-googleworkspacemcp-mvdpgtttyn
    command: uvx
    args:
      - "workspace-mcp"
    env:
      GOOGLE_OAUTH_CLIENT_ID: your-client-id
      GOOGLE_OAUTH_CLIENT_SECRET: your-secret
      OAUTHLIB_INSECURE_TRANSPORT: 1
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "taylorwilsdon-googleworkspacemcp-mvdpgtttyn": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-secret",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      }
    }
  }
}

Похожие MCP-сервера

HuntsDesk/ve-gws

HuntsDesk/ve-gws

от huntsdesk

MCP сервер для Google Workspace с 28 дополнительными инструментами авторской работы: создание слайдов, форматирование документов, управление таблицами и диском. Полный контроль над Gmail, Календарем, Чатами и Формами. Поддержка OAuth 2.1 и CLI.

Python⭐ 2
MarkusPfundstein/mcp-gsuite

MarkusPfundstein/mcp-gsuite

от markuspfundstein

Gmail и Календарь Google: ищет письма, создаёт черновики и ответы, планирует встречи. Поддерживает несколько аккаунтов.

Python⭐ 490
vakharwalad23/google-mcp

vakharwalad23/google-mcp

от vakharwalad23

MCP сервер для интеграции Google-сервисов (почта, календарь, диски, задачи) с AI-клиентами. Позволяет отправлять письма с вложениями, управлять событиями, файлами и задачами. Упрощает автоматизацию рабочих процессов.

TypeScript⭐ 21
takumi0706/google-calendar-mcp

takumi0706/google-calendar-mcp

от takumi0706

MCP-сервер для интеграции Google Календаря с Claude Desktop. Управляйте событиями через естественный язык: создавайте, редактируйте, удаляйте встречи, настраивайте повторения и цвета. Безопасная ау...

TypeScript⭐ 59
Google Calendar MCP

Google Calendar MCP

от nspady

Управляет Google Calendar: создаёт и редактирует события, находит пересечения и свободные окна, импортирует встречи из изображений и ссылок.

TypeScript⭐ 1201
littlebearapps/outlook-assistant

littlebearapps/outlook-assistant

от littlebearapps

MCP-сервер для Outlook, подключающий AI-ассистентов к вашей электронной почте, календарю и контактам. Поддерживает личные Outlook.com и корпоративные Microsoft 365 — поиск, отправку, экспорт писем,...

JavaScript⭐ 39
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин